CreateSkill

Create and validate Skill Units with required frontmatter and workflow references.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/robdtaylor/personal-ai-infrastructure --skill createskill-robdtaylor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: CreateSkill
Source: https://github.com/robdtaylor/personal-ai-infrastructure/tree/main/skills/CreateSkill
Command: npx skills add https://github.com/robdtaylor/personal-ai-infrastructure --skill createskill-robdtaylor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating consistent, valid Skill Units is error-prone without a standardized process. This Skill enforces the required structure and frontmatter to ensure every SkillUnit meets the system's spec.

Core Features & Use Cases

  • Enforces SKILL.md frontmatter with required fields
  • Guides canonical naming and directory structure for new Skills
  • Validates references to Workflows and ensures an Examples section is present
  • Use Case: When authoring a new Skill, run through the workflow to ensure proper setup and validation

Quick Start

  1. Read the SkillSystem.md for structure
  2. Create directory at $PAI_DIR/skills/SkillName/
  3. Create SKILL.md with required frontmatter and sections
  4. Add a Workflows/* if needed and validate references
  5. Run bun run $PAI_DIR/Tools/validate-pack.ts to verify

Frequently Asked Questions about CreateSkill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate SKILL.md frontmatter and structure for a new skill unit?

Canonicalizing a skill directory requires placing SKILL.md under $PAI_DIR/skills/SkillName/ with valid frontmatter. This process enforces consistent naming and structure across the skills/ hierarchy per the SkillSystem specification.

What is the required frontmatter and structure for creating a valid skill?

A valid skill requires a SKILL.md file with required frontmatter fields, an Examples section, and resolvable Workflow references. The structure must conform to the SkillSystem.md specification located in the skills/CORE directory.

Do I need the SkillSystem specification to create and validate skills?

Yes, creating and validating skills requires the SkillSystem specification at skills/CORE/SkillSystem.md. It defines the required frontmatter, directory structure, and validation rules that the skill creation workflow enforces.

How do I validate workflow references in a skill unit?

Validating workflow references involves checking that all Workflows/* paths defined in SKILL.md resolve correctly. The validation script confirms references exist and that an Examples section is present before the skill passes validation.

What are the limitations when canonicalizing skill directory structures?

Canonicalization is limited to enforcing the skills/ hierarchy structure and SKILL.md frontmatter. It does not validate custom logic or external dependencies, only that required fields, Workflow references, and Examples sections meet the spec.