Skill Creator Pro

How This Skill Works

User: "Create a skill for X"
       ↓
Claude Code uses this meta-skill as guidance
       ↓
Follow Domain Discovery → Ask user clarifying questions → Create skill
       ↓
Generated skill with embedded domain expertise

1. Uses this skill's framework to discover domain knowledge
2. Asks user for clarifications about THEIR specific requirements
3. Decides how to structure the generated skill based on domain needs

What This Skill Does

• Guides creation of new skills from scratch
• Helps improve existing skills to production quality
• Provides patterns for 5 skill types (Builder, Guide, Automation, Analyzer, Validator)
• Ensures skills encode procedural knowledge + domain expertise

What This Skill Does NOT Do

• Test skills in production environments
• Deploy or distribute skills
• Handle skill versioning/updates after creation
• Create requirement-specific skills (always create reusable intelligence)

Domain Discovery Framework

Phase 1: Automatic Discovery (No User Input)

Phase 2: Knowledge Sufficiency Check

- [ ] Core concepts understood?
- [ ] Best practices identified?
- [ ] Anti-patterns known?
- [ ] Security considerations covered?
- [ ] Official sources found?

If ANY gap → Research more (don't ask user for domain knowledge)
Only if CANNOT discover (proprietary/internal) → Ask user

Phase 3: User Requirements (NOT Domain Knowledge)

Required Clarifications

Skill Metadata

User Requirements (After Domain Discovery)

• Not "what can it do" but "what do YOU need"

• Languages, frameworks, existing infrastructure

• Performance, security, compliance specific to user's context

Note

• Questions 1-2: Ask immediately
• Domain Discovery: Research automatically after knowing domain
• Questions 3-6: Ask after discovery, informed by domain knowledge
• Question pacing: Avoid asking too many questions in a single message. Start with most important, follow up as needed.

Core Principles

Reusable Intelligence, Not Requirement-Specific

❌ Bad: "Create bar chart with sales data using Recharts"
✅ Good: "Create visualizations - adaptable to data shape, chart type, library"

❌ Bad: "Deploy to AWS EKS with Helm"
✅ Good: "Deploy applications - adaptable to platform, orchestration, environment"

references/reusability-patterns.md

Concise is Key

• "Does Claude really need this explanation?"
• "Does this paragraph justify its token cost?"

Appropriate Freedom

Progressive Disclosure

1. Metadata (~100 tokens) - Always in context (description ≤1024 chars)
2. SKILL.md body (<500 lines) - When skill triggers
3. References (unlimited) - Loaded as needed by Claude

Anatomy of a Skill

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description, allowed-tools?, model?)
│   └── Procedural knowledge (workflows, steps, decision trees)
└── Bundled Resources
    ├── references/   - Domain expertise (structure based on domain needs)
    ├── scripts/      - Executable code (tested, reliable)
    └── assets/       - Templates, boilerplate, images

SKILL.md Requirements

references/skill-patterns.md

name

description

What Goes in references/

When to Generate scripts/

When to Generate assets/

What NOT to Include

• README.md (SKILL.md IS the readme)
• CHANGELOG.md
• LICENSE (inherited from repo)
• Duplicate information

What Generated Skill Does at Runtime

User invokes skill → Gather context from:
  1. Codebase (if existing project)
  2. Conversation (user's requirements)
  3. Own references/ (embedded domain expertise)
  4. User-specific guidelines
→ Ensure all information gathered → Implement ZERO-SHOT

Include in Generated Skills

## Before Implementation

Gather context to ensure successful implementation:

| Source | Gather |
|--------|--------|
| **Codebase** | Existing structure, patterns, conventions to integrate with |
| **Conversation** | User's specific requirements, constraints, preferences |
| **Skill References** | Domain patterns from `references/` (library docs, best practices, examples) |
| **User Guidelines** | Project-specific conventions, team standards |

Ensure all required context is gathered before implementing.
Only ask user for THEIR specific requirements (domain expertise is in this skill).

Type-Aware Creation

skill-patterns.md#builder

skill-patterns.md#guide

skill-patterns.md#automation

skill-patterns.md#analyzer

skill-patterns.md#validator

Skill Creation Process

Metadata → Discovery → Requirements → Analyze → Embed → Structure → Implement → Validate

references/creation-workflow.md

Quick Steps

1. Metadata: Ask skill type + domain (Questions 1-2)
2. Discovery: Research domain automatically (Phase 1-2 above)
3. Requirements: Ask user's specific needs (Questions 3-6)
4. Analyze: Identify procedural (HOW) + domain (WHAT) knowledge
5. Embed: Put gathered domain expertise into

   references/

6. Structure: Initialize skill directory
7. Implement: Write SKILL.md + resources following type patterns
8. Validate: Run

   scripts/package_skill.py

   and test

SKILL.md Template

---
name: skill-name                    # lowercase, hyphens, ≤64 chars
description: |                      # ≤1024 chars
  [What] Capability statement.
  [When] Use when users ask to <triggers>.
allowed-tools: Read, Grep, Glob     # optional: restrict tools
---

references/skill-patterns.md

Output Checklist

Domain Discovery Complete

• Core concepts discovered and understood
• Best practices identified from authentic sources
• Anti-patterns documented
• Security considerations covered
• Official documentation linked
• User was NOT asked for domain knowledge

Frontmatter

• name

  : lowercase, hyphens, ≤64 chars, matches directory

• description

  : [What]+[When], ≤1024 chars, clear triggers

• allowed-tools

  : Set if restricted access needed

Structure

• SKILL.md <500 lines
• Progressive disclosure (details in references/)

Knowledge Coverage

• Procedural (HOW): Workflows, decision trees, error handling
• Domain (WHAT): Concepts, best practices, anti-patterns

Zero-Shot Implementation (in generated skill)

• Includes "Before Implementation" section
• Gathers runtime context (codebase, conversation, user guidelines)
• Domain expertise embedded in

  references/

  (structured per domain needs)
• Only asks user for THEIR requirements (not domain knowledge)

Reusability

• Handles variations (not requirement-specific)
• Clarifications capture variable elements (user's context)
• Constants encoded (domain patterns, best practices)

Type-Specific (see

references/skill-patterns.md

)

• Builder: Clarifications, output spec, standards, checklist
• Guide: Workflow, examples, official docs
• Automation: Scripts, dependencies, error handling
• Analyzer: Scope, criteria, output format
• Validator: Criteria, scoring, thresholds, remediation

Reference Files

references/creation-workflow.md

references/skill-patterns.md

references/reusability-patterns.md

references/quality-patterns.md

references/technical-patterns.md

references/workflows.md

references/output-patterns.md