How do I install the Fix skill?

Run npx skillmds@latest add datit309/fix in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Fix?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

datit309 (@datit309) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Fix by datit309 — Agent Skill

Name: Fix
Author: datit309

File contents

/supergraph:fix

Plan-aware auto-fix loop. Ensure tests pass, lint clean, format applied, graph risks handled.

Usage

/supergraph:fix | /supergraph:fix plan auth-login | /supergraph:fix plan auth-login task 2

Steps

0. Announce

"🔧 /supergraph:fix — starting auto-fix loop..."

1. Select Plan Context

0 plans → skip | 1 → use | >1 → ask | plan <slug> → match. Read ## Environment Context, fix scoped task or all in-progress/stuck tasks.

2. Get Commands

Read from plan ## Environment Context or .supergraph-env (set by /supergraph:scan). Missing → STOP, run scan first. Missing command → skip phase, report as SKIP.

3. Get Changed Files

git diff --name-only && git diff --cached --name-only. Reindex CBM_PROJECT if stale (index_status→index_repository, see references/codebase-memory-contract.md) via codebase-memory-mcp.

3b. Serena pre-loop (optional): See `serena/SKILL.md:Setup`. If scan not run, call `initial_instructions`; `get_diagnostics_for_file` per changed file to catch type errors early. Skip if `SERENA_ACTIVE=false` or unavailable.

4. Auto-Fix Loop (max 3 iterations)

At iteration start: "🔧 Fix iteration N/3 — running tests..."

Phase	Action
Reproduce	Smallest failing cmd + expected vs actual
Tests	Targeted tests else `$TEST_CMD`; fix source. Dedup: if same `HEAD_SHA` and last `PASS <120s` and `git diff` unchanged, reuse evidence; else rerun fresh (respects `verify` freshness guard)
Serena fix	`get_diagnostics_for_file` + `replace_symbol_body`/`rename_symbol` (see `serena/SKILL.md`)
Format+Lint	`$FORMAT_CMD`→`$LINT_CMD`; rerun lint if formatted
Graph	Reindex `CBM_PROJECT` if stale (`index_status`→`index_repository`) — respect `scan: TTL 10m` (skip `index_repository` if fresh per `.supergraph-env`), then `codebase-memory-mcp` recipes `cycles/test-gaps/complexity/cross-boundary`
Decide	All clean→break else continue

5. Update Plan Status (if plan exists)

Succeeded → Status: completed
Failed after 3 → stuck + append STUCK log
Never mark completed if tests or lint fail

6. Report

## Auto-Fix Report
- Iterations: N/3 | Tests: PASS|FAIL|SKIP | Lint: PASS|FAIL|SKIP | Format: PASS|SKIP
- Graph: PASS|WARNING|CRITICAL | Plan status: updated|none
- Issues: [list or "none"]
Next: /supergraph:verify → /supergraph:review

Rules

Max 3 fix iterations
Never commit broken code
Never use git add -A
Never hide failures by weakening tests
Prefer source fixes over test edits
CRITICAL graph findings: fix or escalate
Warnings: fix or report
Prefer mcp__serena__replace_symbol_body for body fixes and mcp__serena__rename_symbol for renames when Serena is available

---name: fixdescription: Plan-aware auto-fix loop after coding. Runs tests, lint, format, and graph checks. Updates plan task status. Use after execute/tdd.---# /supergraph:fixPlan-aware auto-fix loop. Ensure tests pass, lint clean, format applied, graph risks handled.## Usage`/supergraph:fix` | `/supergraph:fix plan auth-login` | `/supergraph:fix plan auth-login task 2`## Steps### 0. Announce"🔧 /supergraph:fix — starting auto-fix loop..."### 1. Select Plan Context0 plans → skip | 1 → use | >1 → ask | `plan <slug>` → match.Read `## Environment Context`, fix scoped task or all in-progress/stuck tasks.### 2. Get CommandsRead from plan `## Environment Context` or `.supergraph-env` (set by `/supergraph:scan`). Missing → STOP, run scan first.Missing command → skip phase, report as `SKIP`.### 3. Get Changed Files`git diff --name-only && git diff --cached --name-only`. Reindex `CBM_PROJECT` if stale (`index_status`→`index_repository`, see `references/codebase-memory-contract.md`) via `codebase-memory-mcp`.### 3b. Serena pre-loop (optional): See `serena/SKILL.md:Setup`. If scan not run, call `initial_instructions`; `get_diagnostics_for_file` per changed file to catch type errors early. Skip if `SERENA_ACTIVE=false` or unavailable.### 4. Auto-Fix Loop (max 3 iterations)At iteration start: "🔧 Fix iteration N/3 — running tests..."| Phase | Action ||---|---|| Reproduce | Smallest failing cmd + expected vs actual || Tests | Targeted tests else `$TEST_CMD`; fix source. **Dedup:** if same `HEAD_SHA` and last `PASS <120s` and `git diff` unchanged, reuse evidence; else rerun fresh (respects `verify` freshness guard) || Serena fix | `get_diagnostics_for_file` + `replace_symbol_body`/`rename_symbol` (see `serena/SKILL.md`) || Format+Lint | `$FORMAT_CMD`→`$LINT_CMD`; rerun lint if formatted || Graph | Reindex `CBM_PROJECT` if stale (`index_status`→`index_repository`) — respect `scan: TTL 10m` (skip `index_repository` if fresh per `.supergraph-env`), then `codebase-memory-mcp` recipes `cycles/test-gaps/complexity/cross-boundary` || Decide | All clean→break else continue |### 5. Update Plan Status (if plan exists)- Succeeded → `Status: completed`- Failed after 3 → `stuck` + append STUCK log- Never mark completed if tests or lint fail### 6. Report```## Auto-Fix Report- Iterations: N/3 | Tests: PASS|FAIL|SKIP | Lint: PASS|FAIL|SKIP | Format: PASS|SKIP- Graph: PASS|WARNING|CRITICAL | Plan status: updated|none- Issues: [list or "none"]Next: /supergraph:verify → /supergraph:review```## Rules- Max 3 fix iterations- Never commit broken code- Never use `git add -A`- Never hide failures by weakening tests- Prefer source fixes over test edits- CRITICAL graph findings: fix or escalate- Warnings: fix or report- Prefer `mcp__serena__replace_symbol_body` for body fixes and `mcp__serena__rename_symbol` for renames when Serena is available

Frequently asked questions

Fix