Meta-Skill Creator

A meta-skill that helps create new skills for AI agents. This skill provides structured workflows, automation scripts, and quality assurance mechanisms for skill development.

Output Language: All generated skill content (SKILL.md, comments, documentation) will be in English.

Quick Start

Create a New Skill

# Initialize a new skill (using npx/bunx)
npx ts-node scripts/init-skill.ts <skill-name> --path <output-directory>

# Or with Bun
bun scripts/init-skill.ts <skill-name> --path <output-directory>

# Example
bun scripts/init-skill.ts my-awesome-skill --path .claude/skills

Validate and Package

# Validate skill structure
bun scripts/validate-skill.ts <skill-folder>

# Package for distribution
bun scripts/package-skill.ts <skill-folder> [output-dir]

Skill Creation Workflow (6 Phases)

Follow these phases in order. Each phase has specific deliverables and validation criteria.

Phase 1: UNDERSTAND

Goal: Gather concrete examples of how the skill will be used.

Questions to Ask:

1. •"What specific scenarios trigger this skill?"
2. •"Can you provide 3-5 concrete usage examples?"
3. •"What keywords should activate this skill?"
4. •"What inputs does it receive? What outputs does it produce?"

Deliverables:

• •Trigger condition list
• •3-5 usage scenarios with examples
• •Expected input/output format

Exit Criteria: Clear understanding of skill purpose and usage patterns.

Phase 2: PLAN

Goal: Identify reusable content and structure.

Analysis Checklist:

Freedom Level Decision:

Deliverables:

• •Directory structure design
• •Progressive Disclosure strategy
• •Freedom level for each component

Phase 3: INITIALIZE

Goal: Create skill directory and template files.

Action: Run the initialization script:

bun scripts/init-skill.ts <skill-name> --path <output-directory>

The script creates:

skill-name/
├── SKILL.md              # Template with placeholders
├── scripts/
│   └── example.ts        # Example TypeScript script template
├── references/
│   └── guide.md          # Example reference template
└── assets/
    └── .gitkeep          # Placeholder for assets

Deliverables: Initialized skill directory with all templates.

Phase 4: IMPLEMENT

Goal: Write skill content and implement resources.

4.1 Write SKILL.md Frontmatter

---
name: skill-name           # Required: kebab-case, max 64 chars
description: |             # Required: triggers + purpose
  Describe the skill and when to use it.
  Triggers: "keyword1", "keyword2", "keyword3"
---

4.2 Write SKILL.md Body

Structure options (choose based on skill type):

4.3 Implement Scripts (TypeScript/JavaScript)

#!/usr/bin/env node
// scripts/my-script.ts

import { readFileSync, writeFileSync } from 'fs';
import { join } from 'path';

async function main() {
  const args = process.argv.slice(2);
  // Implementation here
  console.log('Script execution complete');
}

main().catch(console.error);

• •Test ALL scripts by actually running them
• •Include helpful error messages
• •Handle edge cases gracefully

4.4 Write References

• •Keep SKILL.md under 500 lines
• •Move detailed content to references/
• •Always link references from SKILL.md

Deliverables: Complete skill implementation.

Phase 5: VALIDATE

Goal: Ensure skill meets quality standards.

Run Validation:

bun scripts/validate-skill.ts <skill-folder>

Validation Checklist:

Exit Criteria: All validation checks pass.

Phase 6: PACKAGE

Goal: Create distributable .skill file.

Action:

bun scripts/package-skill.ts <skill-folder> [output-dir]

Output: <skill-name>.skill file (ZIP format with .skill extension)

Post-Package:

1. •Test the packaged skill
2. •Collect usage feedback
3. •Iterate based on real usage

Progressive Disclosure Patterns

Keep context efficient by loading content progressively:

Pattern 1: High-level Guide with References

# Main Skill

## Quick Start
[Essential instructions here]

## Advanced Features
- **Feature A**: See [FEATURE_A.md](references/feature_a.md)
- **Feature B**: See [FEATURE_B.md](references/feature_b.md)

Pattern 2: Domain-Specific Organization

skill/
├── SKILL.md (overview + navigation)
└── references/
    ├── frontend.md    # Frontend-specific
    ├── backend.md     # Backend-specific
    └── deployment.md  # Deployment-specific

Pattern 3: Conditional Details

## Basic Usage
[Simple instructions]

## Advanced (when needed)
**For complex scenarios**: See [ADVANCED.md](references/advanced.md)

Anti-Patterns to Avoid

Platform Compatibility

This skill generates output compatible with:

References

• •Workflow Patterns: See references/workflows.md for detailed workflow guidance
• •Output Templates: See assets/templates/skill-template.md for skill template