update-skill

Read .claude/findings.jsonl, show pending skill findings, and apply approved changes back to the relevant skill file.

Instructions

1. Read .claude/findings.jsonl. If the file does not exist or has no entries where reviewed: false, say "No pending findings." and stop.

2. Filter to reviewed: false entries. Group by skill field. Print a summary table:

| Skill         | Count | Sources           |
|---------------|-------|-------------------|
| fastapi       |   2   | web, gap          |
| (unmatched)   |   1   | web               |

1. Ask the user which skill to process. Work on one skill per invocation.

2. For entries where skill is null: list the query / url / note for each, suggest the most likely skill match by comparing keywords against folder names under skills/*/skill.md, and confirm with the user before proceeding.

3. Read the target skills/<name>/skill.md.

4. For each unreviewed finding for this skill, determine the minimal change:

   • source: "web" — new info from a search: add a checklist item, update a code example, or add a ### subsection if the topic is genuinely new
   • source: "gap" — pattern Claude had to invent: add a code example + checklist item in the most relevant existing section
   • source: "bug" — incorrect content: show the current block and the corrected version side by side as # BEFORE / # AFTER in a fenced block

5. Show every proposed change in full before touching any file. Ask for explicit approval:

   • "Apply these changes? (yes / skip / edit)"
   • "skip" marks the finding reviewed without editing the skill
   • "edit" lets the user paste a corrected version

6. On approval:

   • Edit skills/<name>/skill.md in-place — never rewrite the whole file, never change frontmatter or section order
   • For each processed finding, update its reviewed field to true in findings.jsonl (rewrite that line only)

7. After editing, run /skill-validate to confirm the file still passes CI format checks. If it fails, show the error and offer to fix it before proceeding.