Home / coco-research / coco · systems/gsd/skills/gsd-debug/SKILL.md · GitHub

gsd-debug skillA

gsd-debug is agent-read markdown (skill) from coco-research/coco: Use when a bug, failing test, or unexpected behaviour needs investigation, especially across sessions or context resets. Isolates it in a debugger subagent with persistent .planning/debug state, unlike skills/systematic-debugging..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

<objective>
Debug issues using scientific method with subagent isolation.

**Orchestrator role:** Gather symptoms, spawn gsd-debugger agent, handle checkpoints, spawn continuations.

**Why subagent:** Investigation burns context fast (reading files, forming hypotheses, testing). Fresh 200k context per investigation. Main context stays lean for user interaction.

**Flags:**
- `--diagnose` — Diagnose only. Find root cause without applying a fix. Returns a structured Root Cause Report. Use when you want to validate the diagnosis before committing to a fix.
</objective>

<available_agent_types>
Valid GSD subagent types (use exact names — do not fall back to 'general-purpose'):
- gsd-debugger — Diagnoses and fixes issues
</available_agent_types>

<context>
User's issue: $ARGUMENTS

Parse flags from $ARGUMENTS:
- If `--diagnose` is present, set `diagnose_only=true` and remove the flag from the issue description.
- Otherwise, `diagnose_only=false`.

Check for active sessions:
```bash
ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
```
</context>

<process>

## 0. Initialize Context

```bash
INIT=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state load)
…

Read the whole file at its exact version.

How to install

Latest version
mdr add coco-research/coco/gsd-debug@git:20260914.e75f220
Exact content
mdr add coco-research/coco/gsd-debug@sha256:a9a89f1a347b3216

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260914.e75f220 latest2026-09-14 e75f220 5,090 BA view · diff
git:20260426.d53cc6c2026-04-26 d53cc6c 4,924 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (5090 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

coco-research/coco · 478 stars · license NOASSERTION · pushed 2026-09-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rrv5j72hnpbalcx5
GET https://markdownregistry.com/api/v1/resolve?ref=coco-research/coco/gsd-debug
GET https://markdownregistry.com/api/v1/blob/a9a89f1a347b3216f2a822318566f5b321f16f2d51adada2ba0dc4b8f38d61f4

Your agent 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.

More from coco-research/coco

create-rule skill
coco-research/coco · adapters/cursor/skills/create-rule/SKILL.md · Create Cursor rules for persistent AI guidance. Use when the user wants to create a rule, add coding standards, set up…
git:20260426.d53cc6c · audit A · 478 stars
create-skill skill
coco-research/coco · adapters/cursor/skills/create-skill/SKILL.md · Guides users through creating effective Agent Skills for Cursor. Use when the user wants to create, write, or author a…
git:20260426.d53cc6c · audit A · 478 stars
create-subagent skill
coco-research/coco · adapters/cursor/skills/create-subagent/SKILL.md · Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up…
git:20260426.d53cc6c · audit A · 478 stars
migrate-to-skills skill
coco-research/coco · adapters/cursor/skills/migrate-to-skills/SKILL.md · Convert 'Applied intelligently' Cursor rules (.cursor/rules/*.mdc) and slash commands (.cursor/commands/*.md) to Agent…
git:20260426.d53cc6c · audit A · 478 stars
update-cursor-settings skill
coco-research/coco · adapters/cursor/skills/update-cursor-settings/SKILL.md · Modify Cursor/VSCode user settings in settings.json. Use when the user wants to change editor settings, preferences…
git:20260426.d53cc6c · audit A · 478 stars
agent-lightning skill
coco-research/coco · skills/agent-lightning/SKILL.md · Train and optimize AI agents using Microsoft's Agent Lightning framework with reinforcement learning. Use when setting…
git:20260802.1479e32 · audit A · 478 stars
agent-self-eval skill
coco-research/coco · skills/agent-self-eval/SKILL.md · Post-run self-evaluation system that scores agent output on correctness, clarity, actionability, and conciseness. Use…
v0.1.0 · audit A · 478 stars
ai-marketing-videos skill
coco-research/coco · skills/ai-marketing-videos/SKILL.md · Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for…
git:20260914.57d3294 · audit A · 478 stars
ai-product skill
coco-research/coco · skills/ai-product/SKILL.md · Use when building AI features into a product: LLM integration, RAG pipelines, guardrails, streaming, AI UX, prompt…
v0.1.0 · audit A · 478 stars
api-design-principles skill
coco-research/coco · skills/api-design-principles/SKILL.md · Use when designing a new REST or GraphQL API, reviewing an API spec before implementation, setting team API standards…
git:20260914.e75f220 · audit A · 478 stars
pmstudio-arb skill
coco-research/coco · skills/arb-review/SKILL.md · Generate an Architecture Review Board (ARB) presentation in Coco Inc's standard 11-slide format. Use when someone asks…
git:20260802.1479e32 · audit A · 478 stars
arch-index skill
coco-research/coco · skills/arch-index/SKILL.md · Build and validate .arch/index.json — a committed map from each architectural component of this repository to the real…
v1.0.0 · audit A · 478 stars

Every file in coco-research/coco

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