diagnose
SkillAI & modelsParallel root-cause analysis for bugs and failing tests. Use when a test fails, a bug is reported, or behavior is unexplained, dispatches sub-agents to form and validate hypotheses in isolated worktrees.
Use diagnose in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add diagnose and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the diagnose skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
No other account needed.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
What this skill tells your AI
The instructions your AI receives, as published by griffinwork40/agent-framework in skills/diagnose/SKILL.md and read by ahel’s review.
Gather context: read the failing test or bug description, relevant error output, and recent git changes. If no failing test exists yet, write a minimal reproducer test (or identify a concrete verification command) before proceeding — hypotheses need a pass/fail signal to validate against. Dispatch two sub-agents in parallel — one to search the codebase for code paths involved in the failure (subagent_type: research-agent, read-only), and one to check recent commits and diffs that could have introduced the regression (subagent_type: general-purpose — requires Bash for git log/git diff/git show). When both return, synthesize findings into 2–4 ranked hypotheses, each with a specific code location and proposed cause.
TUI label convention. Set id_prefix on each Agent dispatch to a short, descriptive label so the live progress view shows the agent's role:
- Codebase search agent:
id_prefix: "codebase search" - Git history agent:
id_prefix: "git history" - Each hypothesis-testing agent:
id_prefix: "hypothesis: <one-phrase cause>"(e.g."hypothesis: null deref in parser")
For each hypothesis, dispatch a sub-agent with isolation: "worktree" to apply a minimal speculative fix, run the test or verification command, and then run the broader related test suite to check for regressions. Run all hypothesis-testing agents in parallel. Collect results: which fixes passed, which didn't, and any regressions surfaced by the broader suite.
Report the validated root cause (the hypothesis whose fix passed), the speculative fix diff, and regression status from the broader test run. If no hypothesis passes, synthesize what was learned and form a second round of hypotheses. If the user approves the fix, apply it to the main worktree.
Signals
- GitHub stars
- 23
- Last commit
- Oct 2026
- Hacker News mentions
- 20
Advanced
- Item type
- skill
- Key
diagnose-griffinwork40- Source
- github.com/griffinwork40/agent-framework
github.com/griffinwork40/agent-framework
More in AI & models
Skill · anthropics
More in AI & modelstriage
Skill · mattpocock
More in AI & modelswayfinder
Skill · mattpocock
More in AI & modelsalgorithmic-art
Skill · anthropics
More in AI & modelscode-review-and-quality
Skill · addyosmani
More in AI & modelsmarketing-psychology
Skill · coreyhaines31
More in AI & models