New Skill Scaffolder
Create a new skill in the kungfu repository with the correct structure and conventions.
Usage
When the user asks to create a new skill, follow these steps in order.
Step 1: Gather Info
Ask the user for:
- Skill name (kebab-case, e.g.
my-new-skill) - Description (single line, no newlines, max 1024 chars)
- Subdirectories needed (
references/,scripts/,examples/,templates/,assets/-- all optional)
Step 2: Create Directory and SKILL.md
mkdir -p skills/<skill-name>
Write skills/<skill-name>/SKILL.md with this template:
---
name: <skill-name>
description: <single-line description>
license: MIT
---
# <Skill Title>
<Brief overview of what the skill does and when to use it.>
Step 3: Create Requested Subdirectories
If the user wants references/, scripts/, etc., create them with a
.gitkeep:
mkdir -p skills/<skill-name>/references
touch skills/<skill-name>/references/.gitkeep
Step 4: Add Plugin Symlink
Create a symlink in the business plugin so the skill is discoverable:
ln -s ../../../skills/<skill-name> plugins/business/skills/<skill-name>
Step 5: Validate
Run validation to confirm everything is correct:
just validate
Fix any issues reported before continuing.
Step 6: Update README Table
just readme-table --write
Conventions
- Name: Must be kebab-case, must match the directory name exactly
- Description: Single line, no
\nor\r, no YAML block scalars (|,>) - Orphan rule: Every file in subdirectories must be referenced from SKILL.md via markdown link or backtick
- Word count: Keep under 1500 words
- Sources: Use
[Title](url)markdown link format