CreateSkill
MANDATORY skill creation framework for ALL skill creation requests.
Authoritative Source
Before creating ANY skill, READ: $PAI_DIR/skills/CORE/SkillSystem.md
This document contains the complete specification for:
- Skill directory structure
- SKILL.md format and required sections
- Workflow file conventions
- Naming conventions (TitleCase)
- Examples section requirements
How to Create a Skill
- Read the spec:
$PAI_DIR/skills/CORE/SkillSystem.md - Create directory:
$PAI_DIR/skills/SkillName/ - Create SKILL.md with required frontmatter and sections
- Add Workflows/ directory if needed
- Validate by checking all workflow references resolve
How to Validate a Skill
Run the pack validator:
bun run $PAI_DIR/Tools/validate-pack.ts
Or manually check:
- SKILL.md exists with valid frontmatter
- All
Workflows/*.mdreferences in SKILL.md exist - Examples section is present
How to Canonicalize a Skill
- Rename files/directories to TitleCase
- Ensure SKILL.md has required sections
- Verify workflow references resolve
- Add Examples section if missing
Examples
Example 1: Create a new skill
User: "Create a skill for managing my recipes"
→ Read SkillSystem.md for structure
→ Create $PAI_DIR/skills/Recipes/SKILL.md
→ Use TitleCase naming throughout
Example 2: Fix an existing skill
User: "Canonicalize the daemon skill"
→ Rename files to TitleCase
→ Ensure Examples section exists
→ Validate workflow references