skill-reviewer
what it does
Use this agent when the user has created or modified a skill and needs quality review, asks to "review my skill", "check skill quality", "improve skill description", or wants to ensure skill follows best practices. Trigger proactively after skill creation. Examples: <example> Context: User just created a new skill user: "I've created a PDF processing skill" assistant: "Great! Let me review the skill quality." <commentary> Skill created, proactively trigger skill-reviewer to ensure it follows best practices. </commentary> assistant: "I'll use the skill-reviewer agent to review the skill." </example> <example> Context: User requests skill review user: "Review my skill and tell me how to improve it" assistant: "I'll use the skill-reviewer agent to analyze the skill quality." <commentary> Explicit skill review request triggers the agent. </commentary> </example> <example> Context: User modified skill description user: "I updated the skill description, does it look good?" assistant: "I'll use the skill-reviewer agent to review the changes." <commentary> Skill description modified, review for triggering effectiveness. </commentary> </example>
tools it asks for
Reads files
Same request, same model, once with the agent’s instructions as its system prompt and once without. Neither could use a tool. Read both and judge for yourself.
Claude Sonnet 5.5
made by Anthropic
claude-sonnet-5-5 · revision not reported by the provider
1 try per case · tested 7 Nov 2026
GPT-6.1 Sol
made by OpenAI
gpt-6.1-sol · revision not reported by the provider
1 try per case · tested 7 Nov 2026
example-1
“Can you review my skill? Here's the SKILL.md frontmatter and start of the body: --- name: csv-cleaner description: Helps with CSV files. --- # CSV Cleaner You should use this when working with CSVs. I am going to show you how to clean them. First, you load the file with pandas, then you drop duplicates, then you fix the date columns. Use pandas for everything. The description feels vague to me. How can I improve it so it triggers properly?”
example-2
“I just updated the description of my PDF processing skill and want to know if it looks good for triggering. New description: 'Use this skill when the user wants to extract text, merge, split, or fill forms in PDF files. Triggers on phrases like "extract text from PDF", "merge these PDFs", "split PDF pages", "fill out this PDF form".' The body is about 400 lines in one SKILL.md with no references folder. Please check quality and tell me what to fix.”
Download the .zip and unzip it. Put skill-reviewer.md here:
~/.claude/agents/Every project. For one project only, use .claude/agents/ inside it. It gives the agent the tools it asks for, and no others.~/.cursor/agents/Cursor also reads the Claude Code folder above. It has no tools field, so it gives every agent every tool, whatever this one asks for.Keep its license file beside it, as skill-reviewer.LICENSE: a name that doesn’t end in .md, since every .md file there is read as an agent.
Then start a new session and ask for it by name. Folders checked 6 November 2026.
Or install from your agent: ask it to install skill-reviewer from Carte Blanche.