- name
- CreateSkill
- description
- Create and validate skills. USE WHEN create skill, new skill, skill structure, canonicalize. SkillSearch('createskill') for docs.
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.tsOr 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 throughoutExample 2: Fix an existing skill
User: "Canonicalize the daemon skill"
→ Rename files to TitleCase
→ Ensure Examples section exists
→ Validate workflow references