fix-bug SKILL.md skillA

fix-bug from nanosite-ai/nanoflow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nanosite-ai/nanoflow/fix-bug@git:20261007.050f6df

Pins git:20261007.050f6df in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nanosite-ai/nanoflow
Path
skills/fix-bug/SKILL.md
Versions recorded
1
Latest version
git:20261007.050f6df, committed Oct 7, 2026
Size
1,990 bytes
Repository stars
14
License
MIT

Fix a bug by reproducing it with a failing test first, finding the root cause, and watching the same test pass. Use for any bug report, regression, or "this is broken" request.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Fix a bug: failing test first

A fix you can't show failing-then-passing is a guess. The reproducing test stays in the suite as a
permanent guard.

1. **Ticket.** `nf task start --new "<symptom in plain words>" --type bug --definition "<symptom>" --plan "<steps to reproduce>"`
   (or claim the existing issue). Work in the worktree it creates.
2. **Reproduce with a failing test at the lowest layer that shows it.**
   - pure logic → a unit test next to the file;
   - API / database / auth → an integration test;
   - only in the browser (refresh, cookies, navigation, hydration) → an e2e test (Playwright).

   Assert the correct behaviour, run only that test, and watch it **fail**.
3. **Check it fails for the reported reason.** A test that fails for another reason, or passes before any
   change, is testing the wrong thing. Fix the test first.
4. **Name the root cause in one sentence** before editing. Trace the real path and fix the cause, in the
   layer it lives in, not where it surfaced.
5. **Fix it**, minimally.
6. **Watch the same test pass**, unchanged. (nanoflow shows a "now passes" toast when a red check turns green.)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nanosite-ai/nanoflow/fix-bug@sha256:a97a7bb4834e78d3

The line at the top of this page pins the label git:20261007.050f6df, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_i63ago72tkcovlsx.svg)](https://markdownregistry.com/a/art_i63ago72tkcovlsx)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 7, 2026.

versioncommittedcommitsizeaudit
git:20261007.050f6df latest2026-10-07 050f6df 1,990 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1990 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nanosite-ai/nanoflow · 14 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i63ago72tkcovlsx
GET https://markdownregistry.com/api/v1/resolve?ref=nanosite-ai/nanoflow/fix-bug
GET https://markdownregistry.com/api/v1/blob/a97a7bb4834e78d3eb1edc002e3e2f8de9f146ea6dfa73aa4e6b51224cf61bc0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nanosite-ai/nanoflow

pr-screenshots SKILL.md skill
nanosite-ai/nanoflow · skills/pr-screenshots/SKILL.md · Verify a visual change in a real browser with the Playwright MCP and attach before/after screenshots to its PR. Use…
git:20261007.050f6df · audit A · 14 stars
worktree-lifecycle SKILL.md skill
nanosite-ai/nanoflow · skills/worktree-lifecycle/SKILL.md · Run every task as ticket → its own git worktree + branch on its own ports → PR → merge → teardown, with nanoflow. Use…
git:20261012.79d0bdb · audit A · 14 stars
wrap-up-summary SKILL.md skill
nanosite-ai/nanoflow · skills/wrap-up-summary/SKILL.md · End a task with a short recap and a structured status footer (worktree, branch, PR, ticket, done, local URL, next…
git:20261007.050f6df · audit A · 14 stars

Every file in nanosite-ai/nanoflow

Other files named fix-bug

fix-bug SKILL.md skill
nowsprinting/unity-coding-skills · skills/fix-bug/SKILL.md · Diagnoses and fixes bugs using a test-first workflow (reproduce, diagnose, fix). Use this skill whenever the user…
git:20261016.1a93bbe · audit A · 20 stars
fix-bug SKILL.md skill
mgiovani/cc-arsenal · skills/fix-bug/SKILL.md · Fixes a bug through test-driven debugging, reproduces it with a failing
git:20261005.b620662 · audit A · 8 stars

Browse by kind, by grade A, or by owner.