Skill Generator

A meta-skill for creating and maintaining project context skills in Claude Code. Enables zero context loss between chat sessions.

Purpose

Generate and maintain comprehensive Claude Code skills that preserve project context between chat sessions.

Goal: Zero context loss. A new session should be able to pick up exactly where the previous one left off.

Installation

Copy the entire folder to your Claude Code skills directory:

# For global availability (all projects)
cp -r skill-generator ~/.claude/skills/

# Or for project-specific use
cp -r skill-generator .claude/skills/

When to Use

Explicit Triggers (user requests)

• "create a skill for this project"
• "update the skill" / "update the project skill"
• "save this context"
• "remember this for next session"
• "generate a skill file"

Proactive Triggers (Claude offers automatically)

• Session exceeds ~30 minutes of project-specific work
• Significant decisions were made (architecture, tech choices, patterns)
• Complex problems were solved (with solutions worth preserving)
• Technical patterns or gotchas were discovered
• Multi-step implementations were completed
• User asks "what did we do today" or similar wrap-up questions

Structure

skill-generator/
├── SKILL.md                              # Entry point (~270 lines)
├── Reference/
│   ├── formatting-standards.md           # All formatting rules
│   ├── phase-procedures.md               # Detailed 6-phase workflow
│   └── skill-maintenance.md              # Update governance for this skill
└── Templates/
    ├── project-skill-template.md         # SKILL.md starting template
    ├── maintenance-template.md           # skill-maintenance.md template
    └── entity-template.md                # Template for entity files

Core Principles

1. Single Skill Architecture - ONE skill per project/domain, not fragments
2. Snippetizable Content - Clear headers, tables, bullets for easy extraction
3. Zero Context Loss - If losing it would hurt, capture it
4. White-Paper Ready - Technical specs at handoff quality
5. Never Delete, Only Supersede - Preserve history with [SUPERSEDED] markers

Quick Start

1. When starting work on a project, trigger skill creation with "create a skill for this project"
2. Claude will analyze the conversation and create a structured skill
3. At session end or when prompted, Claude will offer to update the skill
4. The next session loads the skill automatically, preserving all context

Verification Checklist (25 points)

Every generated skill is verified against:

• 8 Structure checks - Required files and sections
• 8 skill-maintenance.md checks - Governance completeness
• 6 Content checks - Quality and completeness
• 3 Principle checks - Core philosophy adherence

See Reference/phase-procedures.md § Verification for the full checklist.

License

MIT License - Feel free to use, modify, and share.

Contributing

Issues and pull requests welcome. This skill was designed for the Claude Code ecosystem but the patterns may apply to other AI assistants.