agent-design-review
Review an LLM agent design and find where it will be unreliable, expensive, or unsafe. Use when asked to review an agent architecture, critique a multi-step/tool-using agent, debug an agent that loops or goes off-task, or harden an agent before launch. Produces a structured review — task fit, control flow, tools, memory/context, failure handling, cost, and safety — with prioritised findings and fixes.
npx skills add mohitagw15856/pm-claude-skills --skill agent-design-review --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Agent Design Review Skill Most agents don't fail because the model is weak — they fail because the *design* lets them loop, call the wrong tool, lose the thread across steps, or burn tokens with no stopping rule. This skill reviews an agent's architecture against the decisions that actually determine reliability, and ranks the fixes — so "it works in the demo but not in prod" becomes a specific list of changes. (Writing a new agent spec? Use [`agent-spec`](../agent-spec/SKILL.md).) ## Working from a brief Given a sketch ("a research agent that searches, reads, and writes a report"), **deliver the full review anyway** — infer the likely control flow and tools, label the inference, and flag what to confirm. Never withhold the review for missing detail. ## Required Inputs Ask for these only if they aren't already provided (else infer and label): - **What the agent does** — its goal, and what a successful run produces. - **Control flow** — single prompt, plan-then-execute, ReAct loop, or multi-agent; and the stopping condition. - **Tools & actions** — what it can call, and which actions have side effects (write, send, pay). - **Memory & context** — what state carries across steps, an
- Working from a brief
- Required Inputs
- Output Format
- Agent Review: [agent]
- Quality Checks
- Anti-Patterns
- Based On
What does the agent-design-review skill do?
Review an LLM agent design and find where it will be unreliable, expensive, or unsafe. Use when asked to review an agent architecture, critique a multi-step/tool-using agent, debug an agent that loops or goes off-task, or harden an agent before launch. Produces a structured review — task fit, control flow, tools, memory/context, failure handling, cost, and safety — with prioritised findings and fixes.
How do I install it?
Run `npx skills add mohitagw15856/pm-claude-skills --skill agent-design-review --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From mohitagw15856/pm-claude-skills, a repository with 1,255 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.