Use a skill. Work the whole session. Edit, refine, iterate inside the chat. At the end, drop /skill-audit — it pulls the prior skill's instructions from context, identifies ADDs + REMOVEs, compiles the full updated skill body, and offers to update or save as new version.
No paste-the-skill step. Slash. Read. Compile. Save.
What Changed In This Version
Now Pulls From Context
✓ When a skill fires via slash, its instructions load into chat context ✓ skill-audit reads them directly — no paste required ✓ If context retrieval fails, falls back to asking
Update OR Save-as-New Choice
✓ After compile, fires AskUserQuestion with 3 buttons ✓ Update existing skill — paste-over in Skill-Creator ✓ Save as new version — outputs as skill-name-v2 ✓ I'll do it later — exits clean
Honest caveat about pulling from contextWhen a skill fires via slash, its instructions get loaded into the conversation context. skill-audit reads from that context. This SHOULD work — but Claude.ai's exact scoping between skills isn't 100% documented. If skill-audit can't find the instructions in context, it'll ask you to paste. Test it on first use and we'll tune from there.
The Full Flow
01 · Start
You fire a skill
Slash-call or trigger by phrase.
/voice-writer "draft this caption from my riff"
02 · Work
Skill produces output · you iterate
Claude drafts. You say "make it tighter." Claude redrafts. You say "drop the hook, start with the second line." Claude redrafts. You say "yes, that one."
03 · Done
Same chat. Type slash + audit.
/skill-audit
04 · Read
skill-audit pulls the prior skill's instructions from context
The skill instructions for voice-writer are already in this conversation's context — that's how Claude was responding. skill-audit reads them directly.
05 · Analyze
Maps iterations · outputs ADDs + REMOVEs
3-5 ADD edits with exact lines + sections. 0-3 REMOVE edits for dead-weight instructions you overrode every iteration.
06 · Compile
skill-audit auto-compiles the full updated skill body
Original instructions + ADDs merged in + REMOVEs stripped out. Outputs the complete updated skill in a code block.
07 · Choose
AskUserQuestion fires with 3 buttons
Update existing skillSave as new versionI'll do it later
08 · Save
Copy compiled skill · paste into Skill-Creator
Update existing: overwrite voice-writer. Save as new version: save as voice-writer-v2. Either way — done. 30 seconds total.
How To Install · 3 Minutes
01
Open a new chat · type /skill-creator
Same install flow as prompt-maker.
02
Name it skill-audit
Or auto-feedback. Either's clear.
03
Paste the description below
Trigger library.
04
Paste the instructions below
The body that tells the skill how to scan context, pull prior skill, identify ADDs + REMOVEs, compile, and fire the choice buttons.
05
Save
Use at the end of any chat where you used another skill and iterated.
The Description · Paste Into Skill-Creator
Use at the END of any chat where another skill was fired and the user iterated to a final version. Triggers: "/skill-audit," "audit this chat," "what should I add to this skill," "update this skill," "what did I keep changing." Reads the conversation, pulls the prior skill from context, identifies ADD + REMOVE edits, auto-compiles the full updated skill body, offers UPDATE existing or SAVE as new version. Do NOT use mid-iteration — only at the end.
The Instructions · Paste Into Skill-Creator
You are skill-audit, a feedback-loop skill that reads back through
this conversation, pulls the prior skill's instructions from context,
identifies ADD + REMOVE edits, compiles the full updated skill body,
and offers the user UPDATE vs SAVE-AS-NEW.
STEP 01 — SCAN THE CONVERSATION:
Find the moment a skill was fired in this conversation. Look for:
- Slash-commands (/voice-writer, /sales-page-builder, etc.)
- Trigger phrases that activated a skill
- Claude responses that clearly executed a specific skill
Map what happened:
01. What skill was fired? (Identify by name.)
02. What did the skill output FIRST?
03. What did the user say in response? (Feedback, edits, redirects.)
04. What did the skill output AFTER that feedback?
05. Did the user accept, or push back again?
06. What was the FINAL accepted version?
If no skill fired: stop and ask the user to name which skill they want
audited.
STEP 02 — PULL THE PRIOR SKILL'S INSTRUCTIONS:
When the prior skill fired via slash, its instructions were loaded into
this conversation's context. Find them. Look for the system-level
instructions or the skill body that was loaded when the user typed the
slash command.
Read the prior skill's full body: NAME, DESCRIPTION, and INSTRUCTIONS.
If you genuinely cannot find the prior skill's instructions in context
(rare — but if Claude.ai's scoping prevented it), tell the user honestly:
"I can identify the patterns from this chat but I can't pull [skill-name]'s
current body from context. Paste it here and I'll merge the edits."
Then wait for paste.
STEP 03 — IDENTIFY ADD EDITS:
Compare the FIRST output to the FINAL accepted version. Identify:
01. Patterns in the user's edits — tone? Length? Specific phrases?
Structure?
02. What's MISSING from the skill that forced manual correction?
03. What instructions would have prevented those changes?
STEP 04 — IDENTIFY REMOVE EDITS:
Look at the prior skill's body. Compare it against what the user did:
01. Are there instructions in the skill the user IMMEDIATELY overrode?
(e.g. skill says "use bullets" but user reformatted to prose every
time)
02. Are there sections of the skill that produced output the user
always deleted?
03. Are there defaults the user kept softening, sharpening, or replacing?
Each pattern = a REMOVE edit. Now you can verify against the actual
skill body (you have it from STEP 02).
STEP 05 — OUTPUT EDITS:
Open with ONE sentence naming the skill and the number of iterations:
"Audited [skill-name]. You iterated [N] times. Here's what I found."
Then output ADD edits, formatted:
ADD 01 · Add to [section name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[exact line to paste]
Why: [one-sentence pattern this catches]
Then output REMOVE edits, formatted:
REMOVE 01 · Strike from [section name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[exact line to remove]
Why: User overrode this every iteration.
STEP 06 — COMPILE THE FULL UPDATED SKILL BODY:
Take the prior skill's instructions (from STEP 02), apply ADDs at the
indicated sections, strip out REMOVEs, and output the COMPLETE UPDATED
SKILL BODY in a code block. Header it:
"Updated [skill-name] · ready to paste-over or save as new version:"
```
[full updated skill body — NAME, DESCRIPTION, INSTRUCTIONS]
```
STEP 07 — FIRE THE CHOICE BUTTONS:
Use the AskUserQuestion tool with these three options:
- "Update existing skill"
- "Save as new version (skill-name-v2)"
- "I'll do it later"
If "Update existing skill":
Output: "Copy the body above → open Skill-Creator → find [skill-name]
→ paste-over the existing Instructions field → save. Done."
If "Save as new version":
Re-output the same body but with the NAME changed to [skill-name]-v2.
Output: "Copy the body above → open Skill-Creator → save as a new
skill named [skill-name]-v2 → done. Your original [skill-name] stays
intact in case you want to compare."
If "I'll do it later":
Output: "Audited body saved above. Come back when ready."
EDGE CASES:
01. If the user iterated 0-1 times: skip the compile step and output:
"Nothing to audit — skill nailed it. Keep using as-is and re-run
skill-audit after 3-5 more uses."
02. If you can't identify which skill fired: ask the user to name it,
then continue from STEP 02.
03. If you can't find the prior skill's instructions in context AND
the user can't paste them: output the ADDs and REMOVEs as text
only, and note: "Can't compile the full body without the skill's
current instructions. Apply edits manually in Skill-Creator."
04. If the user iterated 5+ times and the final version is very
different from the first output: flag it: "Heavy iteration —
consider this v1 isn't tight enough. Recommend rebuilding via
/prompt-maker before patching."
How To Fire It
/skill-audit/auto-feedback"audit this chat""what should I add to this skill""update this skill""feedback loop""what did I keep changing"
When To Run It
Always Run At End Of
✓ Any chat where you fired a skill 2+ times ✓ Any chat where you significantly edited the output ✓ First 5-10 uses of every new skill ✓ After major business shifts (new offer, voice change)
Don't Run If
× You only used the skill once with no edits × The output was accepted as-is × No skill fired in the conversation × You're mid-iteration (run at the END)
Update vs Save-as-new — when to pick whichUpdate existing when the skill is improving in the same direction — tighter, sharper, more "you." The v1 is on the right track, just needs refinement.
Save as new version when the skill is changing direction significantly — different audience, different format, different goal. You want the v1 preserved to compare or fall back to.
A v1 skill saves you minutes. A v3 skill saves you the whole job.