analyzer — Claude Code subagent: comparison analysis and setup
analyzer examines blind skill comparisons to explain the winner’s advantage and suggest changes to the losing skill. Run it after the comparator finishes.
no license ★ 406 updated 2026-06-25
.claude/agents/analyzer.mdWhat analyzer does
The subagent examines the comparator’s result alongside both skills and their execution transcripts. It looks for differences that could explain the outcome, including how clearly each skill guides the agent, which tools the agent uses, and how it handles errors. It needs the comparison result and both transcripts to carry out this analysis.
The output is a JSON report with a comparison summary, winner strengths, loser weaknesses, instruction-following scores, and proposed changes. Suggestions can cover instructions, tools, examples, error handling, structure, or references, with a priority assigned to each. This gives you a concrete revision plan for the losing skill.
What it helps with
- explain why one skill won a blind comparison
- spot gaps between skill instructions and agent actions
- score how well each agent followed its skill
- prioritize revisions to the losing skill
Example prompts for the agent
- Compare the two skill runs and save your analysis to
analysis.json. - Explain why the skill at
winner_skill_pathwon, then suggest revisions for the other skill. - Review both execution transcripts and score instruction following.
How to install analyzer
Manually: put the files in place
.claude/agents/analyzer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/analyzer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/analyzer.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about analyzer
How do I install analyzer in Claude Code?
Add the subagent file to your project at .claude/agents/analyzer.md.
What does analyzer do?
It reviews a blind comparison, the two skills, and their execution transcripts to explain the result and propose specific improvements to the losing skill.
What does analyzer need to run an analysis?
Provide the winning side, paths to both skills and transcripts, the comparator’s result JSON, and a destination for the analysis.