skill-create

/skill-create — Generate a New Skill from Git History

Analyzes git log to detect patterns, then generates a new skill file that matches the workspace's writing-skills spec.

When to Use

• You've noticed a repeated workflow not yet captured in a skill
• A pattern has emerged from 3+ similar commits
• You want to codify a debugging or implementation technique

Process

Step 1: Analyze git history

git log --oneline -n 200 --name-only | head -300

Detect:

• Commit conventions — what prefixes appear? (feat:, fix:, refactor:)
• File co-changes — which files always change together? (signals a workflow)
• Workflow sequences — do commits follow a pattern? (e.g., schema → service → controller → test)
• Architecture patterns — which directories are touched most often?

Step 2: Identify the pattern

State the pattern in one sentence:

"Every time we add a NestJS endpoint, we touch: DTO → service → controller → e2e test, in that order."

If no clear pattern emerges from 200 commits, report: "No repeated pattern detected. Provide a manual description of the skill you want to create."

Step 3: Generate the skill

Output a complete skill file matching the writing-skills spec:

Required frontmatter fields:

---
name: {skill-name}
description: {CSO trigger words — "Use when...", specific scenario, not vague}
allowed-tools: {minimal set — only what the skill needs}
metadata:
  triggers: {comma-separated trigger words}
  related-skills: {comma-separated related skill names}
  domain: {backend|frontend|mobile|infrastructure|quality|architecture}
  role: {specialist|reviewer|generator}
  scope: {implementation|review|design|testing}
  output-format: {code|report|plan}
last-reviewed: "{YYYY-MM-DD}"
---

Required body sections (in this order):

1. **Iron Law:** — one mandatory rule, no exceptions
2. Summary — 2-3 sentences on what this skill does
3. Process — numbered steps
4. Key patterns — code examples
5. Anti-patterns — at least 1 explicit "don't do this"
6. Error handling — what to do when things go wrong
7. References section — links to related files