What problem does it solve?
Creating a new skill project from scratch is slow and inconsistent, so this kata provides a repeatable way to scaffold the correct directory structure and configuration from the framework template.
Core Features & Use Cases
- Slug validation & safety checks: Enforces a strict slug format, rejects reserved words, and validates description length to prevent invalid project metadata.
- Deterministic project scaffolding: Copies the framework skill-project-sample template into
skills/{slug}/ (or the configured root) and replaces placeholders consistently (slug, language, title, license).
- Configurable opt-outs: Can remove or tailor
widgets/, tools/, and scripts/ based on flags, including selecting JS runtime for scripts.
- Guardrails & validation: Refuses to overwrite existing destinations, updates
.gitignore to include the build output folder when missing, and verifies that the generated SKILL.md and skill.config.json exist and contain no leftover placeholders.
Quick Start
Have the AI run /cry-new-skill with a valid slug and description to generate a new project at {paths.skills_root}/{slug}/ from the template, optionally applying the widgets/tools/scripts opt-outs.