Meta Skill Creator

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: What the skill does. This skill should be used when [specific contexts].
---

Description best practices:

• Use third-person format: "This skill should be used when..."
• Include both what the skill does AND when to use it
• Be specific about trigger contexts
• Keep it concise (no strict word limit)

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
• Agent Patterns: See references/agent-patterns.md for meta-agent creation
• Output Templates: See assets/templates/ for templates

Converted and distributed by TomeVault — claim your Tome and manage your conversions.