Diagnose Before Plan

by Optim-Agent

Diagnose Before Plan is an AI Engineering skill for Claude Code, published by Optim-Agent in optim-plans.

489 stars1 forkson Optim-Agent/optim-plansAdded 2026/08/11+35% in starsRepository updated 2026/08/09

View source on GitHub Download repo ZIP

agent-skillsbrainstormingclaude-skillscodex-skillsdeveloper-toolsgrill-mehuman-in-the-looplooploop-engineeringplanning

Install in seconds

Install Diagnose Before Plan

Copy Diagnose Before Plan into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/Optim-Agent/optim-plans/tree/main/skills/diagnose-before-plan ~/.claude/skills/diagnose-before-plan

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/Optim-Agent/optim-plans.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/diagnose-before-plan/SKILL.md in Optim-Agent/optim-plans
Installs to: ~/.claude/skills/diagnose-before-plan
Collection: One of 5 skills cataloged from this repository
Category: AI Engineering — 2451 skills

What Diagnose Before Plan does

A diagnostic workflow that performs root cause analysis on bugs, test failures, CI issues, and incidents before deciding whether to create a fix plan. It guides the user through evidence inspection and RCA summary, then offers to proceed with a scoped plan.

Diagnose Before Plan is cataloged under AI Engineering on DirSkills. Diagnose Before Plan comes from a repository tagged agent-skills, brainstorming, claude-skills, codex-skills and developer-tools.

Documentation

README

Excerpt

Diagnose Before Plan

Use this skill for problem or failure inputs that need diagnosis before planning.

Setup

Read ../_shared/references/prime-planning-workflow.md, ../_shared/references/state-and-config.md, and ../_shared/references/plan-artifact-template.md.
Use .git/optim-plans for controller state and docs/optim-plans/YYYY-MM-DD-topic/ for public artifacts.
Preserve reviewer and criticizer settings for any selected planning skill.

Diagnostic Workflow

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Diagnose Before Plan

What else does Optim-Agent publish alongside Diagnose Before Plan?
Diagnose Before Plan is one of 5 skills that DirSkills catalogs from Optim-Agent/optim-plans, the repository it ships in. Its siblings there include Create a Big Plan, Create a Plan and Create a Small Plan. Each one is a separate skill with its own page in this directory, installs the same way Diagnose Before Plan does, and is maintained by Optim-Agent in that same repository. The rest of the collection is listed on the Optim-Agent/optim-plans page.
How does Diagnose Before Plan compare to other AI Engineering skills?
Diagnose Before Plan ranks #2196 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Diagnose Before Plan against them. Open each page to compare what they document and how they install.