createskill

edheltzel's avatarfrom edheltzel

Create and validate skills. USE WHEN create skill, new skill, skill structure, canonicalize. SkillSearch('createskill') for docs.

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 7, 2026

When & Why to Use This Skill

This Claude skill provides a comprehensive framework for the creation, validation, and standardization of agent capabilities. It streamlines the development lifecycle by enforcing strict directory structures, naming conventions, and documentation requirements, ensuring that every new skill is robust, discoverable, and fully compatible with the core agent infrastructure.

Use Cases

  • Standardized Skill Creation: Quickly generate the necessary directory structure and SKILL.md files for new agent functionalities while adhering to the mandatory TitleCase naming conventions.
  • Automated Validation: Run integrity checks using the pack validator to verify that all workflow references resolve correctly and that mandatory sections like 'Examples' are present.
  • Legacy Skill Canonicalization: Refactor and update older or non-compliant skills to meet current architectural standards, ensuring consistency and reliability across the entire skill library.
namecreateSkill
descriptionAtlas skill for creating and validating skills. USE WHEN create skill, new skill, skill structure, canonicalize. SkillSearch('createskill') for docs.
contextfork

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

  1. Read the spec: $PAI_DIR/skills/CORE/SkillSystem.md
  2. Create directory: $PAI_DIR/skills/SkillName/
  3. Create SKILL.md with required frontmatter and sections
  4. Add Workflows/ directory if needed
  5. 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

  1. Rename files/directories to TitleCase
  2. Ensure SKILL.md has required sections
  3. Verify workflow references resolve
  4. 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