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:
bash
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
code
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
code
User: "Canonicalize the daemon skill" → Rename files to TitleCase → Ensure Examples section exists → Validate workflow references