shinpr

Agent Clinic — Development skill for Claude Code

Development community

Diagnostic plugins for Claude Code and Codex: why a session went wrong, and whether a proposed change is too much or too little for the outcome.

How to install Agent Clinic

This entry records only its repository, not the path inside it, so there is no exact command to give. Open shinpr/agent-clinic and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Clinic does

Diagnostic plugins for Claude Code and Codex: why a session went wrong, and whether a proposed change is too much or too little for the outcome.

Alternatives in Development

README

Agent Clinic

![Agent Clinic banner](docs/assets/agent-clinic-banner.jpg)

Diagnostics for agent-assisted work. Each one is a separate plugin, and you install only the ones you want.

Plugin What it is for How it runs Needs
Session Doctor A session went badly and you want to know why. You ask for it Nothing
Outcome Doctor A plan, design, or diff may be more or less than the job needs. On its own, while your agent works A TypeSafe API key

Both report what they found and leave the fixes to you. Neither one edits your code.

Add the marketplace once:

/plugin marketplace add shinpr/agent-clinic
codex plugin marketplace add shinpr/agent-clinic

Session Doctor

Looks back at one of your past Claude Code or Codex sessions and tells you what to change.

Sessions go wrong for boring reasons. A request with no "done" condition. A task that quietly vanished at a compaction. A skill that overrode one of your own rules. Session Doctor reads the saved transcript and looks for problems like these:

  • What you asked for: where the request left the outcome, scope, or "done" undefined.
  • How the work was run: work the agent started but never finished, state lost during compaction, subagent results that were never checked.
  • What was instructing the agent: your skills, AGENTS.md and CLAUDE.md as they actually combined in that session, including rules that conflict or duplicate each other when they apply at the same time.

The three passes run separately, so a hunch from the first does not bias the other two. The report shows what went wrong, where it happened, and the smallest change likely to prevent it next time.

Install

/plugin install session-doctor@agent-clinic
codex plugin add session-doctor@agent-clinic

Start a new session afterwards so the skill is loaded.

Use

/recipe-diagnose   # Claude Code
$recipe-diagnose   # Codex

T