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/*.md references 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