skill-forgelisted
Install: claude install-skill Mfrostbutter/skill-forge
# Skill Forge
Turn a WORKLOG.md into a skill. The journal's tags map directly onto skill sections, so synthesis is mostly routing.
## Step 1: Read the worklog
Read the full `_worklogs/<date-slug>/WORKLOG.md`. If the user references a workflow without a path, find the matching worklog.
## Step 2: Route by tag
- DECISION + SEQUENCE -> the procedure: ordered, imperative steps.
- CORRECTION + DEADEND -> guardrails: "do not", "always", warnings, each with the one-line reason.
- CONVENTION + DISCOVERY -> reference files and compatibility notes.
A DEADEND that blocked progress usually becomes an early SEQUENCE step in the procedure so it cannot recur.
## Step 3: Draft SKILL.md
Read `references/skill-anatomy.md` first. Then produce:
- name: kebab-case identifier.
- description: the trigger. Make it pushy and list concrete contexts; Claude tends to undertrigger skills. Put all "when to use" info here, not in the body.
- body: imperative voice, under ~500 lines. Explain why a rule matters rather than stacking bare MUSTs.
- references/: push variant-specific or long details out of the body. Files over ~300 lines get a table of contents.
- scripts/ and assets/ only if the workflow has deterministic steps or output templates.
## Step 4: Validate
Adapt to the environment.
- Subagents available (e.g. Claude Code): run 2 to 3 realistic test prompts, baseline vs with-skill, grade, review the results.
- No subagents (e.g. a chat client): run test prompts inline, one at a time, usin