Agent skill

Spec Debug

诊断并修复 Spec 执行过程中发现的问题。由角色 spec-debugger 调用。触发条件：(1) 角色 spec-debugger 接收到 TeamLead 转交的 bug handoff，(2) spec-executor 执行后出现 bug 或 writer/plan.html 中未考虑到的情况，(3) 运行时出现问题、依赖环境或配置问题，(4)…

No licenceAuto-check passed

Install Spec Debug

skills CLI

$ npx skills add HHU3637kr/skills --skill spec-debug -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install HHU3637kr/skills spec-debug --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/HHU3637kr/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/spec-debug .claude/skills/spec-debug && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "spec-debug" agent skill from https://github.com/HHU3637kr/skills/tree/master/spec-debug into .claude/skills/spec-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spec-debug", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/HHU3637kr/skills/tree/master/spec-debug

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add HHU3637kr/skills --skill spec-debug -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install HHU3637kr/skills spec-debug --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HHU3637kr/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/spec-debug .agents/skills/spec-debug && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "spec-debug" agent skill from https://github.com/HHU3637kr/skills/tree/master/spec-debug into .agents/skills/spec-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spec-debug", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HHU3637kr/skills --skill spec-debug -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install HHU3637kr/skills spec-debug --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HHU3637kr/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/spec-debug .cursor/skills/spec-debug && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "spec-debug" agent skill from https://github.com/HHU3637kr/skills/tree/master/spec-debug into .cursor/skills/spec-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spec-debug", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/HHU3637kr/skills.git --path spec-debug

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add HHU3637kr/skills --skill spec-debug -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install HHU3637kr/skills spec-debug --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HHU3637kr/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/spec-debug .gemini/skills/spec-debug && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "spec-debug" agent skill from https://github.com/HHU3637kr/skills/tree/master/spec-debug into .gemini/skills/spec-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spec-debug", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install HHU3637kr/skills spec-debug

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add HHU3637kr/skills --skill spec-debug -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/HHU3637kr/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/spec-debug .github/skills/spec-debug && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "spec-debug" agent skill from https://github.com/HHU3637kr/skills/tree/master/spec-debug into .github/skills/spec-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spec-debug", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HHU3637kr/skills --skill spec-debug -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install HHU3637kr/skills spec-debug --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HHU3637kr/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/spec-debug .opencode/skills/spec-debug && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "spec-debug" agent skill from https://github.com/HHU3637kr/skills/tree/master/spec-debug into .opencode/skills/spec-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spec-debug", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: spec-debug
GitHub stars: 145
Token cost: ~2.6k tokens
SKILL.md length: 409 words
Files: 5 (incl. references)
Skills in repo: 37
Repo updated: Sep 23, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

Works in 5 steps: 根因优先：没有验证过的根因，不改代码。先写下单一可证伪的假设，再设计能推翻它的最小… → 不修改已确认的 writer/plan.html：通过创建 debug… → 闭环协作：接收 TeamLead 转交的 bug handoff → 修复 →… → …
SKILL.md covers 运行契约, 核心原则, 协作闭环 and 工作流程, plus 2 more sections
Calls bash

What it does

Spec Debug is an agent skill from HHU3637kr/skills. 诊断并修复 Spec 执行过程中发现的问题。由角色 spec-debugger 调用。触发条件：(1) 角色 spec-debugger 接收到 TeamLead 转交的 bug handoff，(2) spec-executor 执行后出现 bug 或 writer/plan.html 中未考虑到的情况，(3) 运行时出现问题、依赖环境或配置问题，(4) 用户要求诊断/修复线上问题、偶发故障、异常报错、环境依赖问题或回归排查。不修改已确认的 writer/plan.html，而是在 debugger/ 下创建独立的诊断文档（debug-xxx.html）和修复总结（debug-xxx-fix.html）。修复完成后向 TeamLead 提交重新验证请求，由 TeamLead 启动 spec-tester。触发词：诊断、修复、线上问题、偶发 500、复现、回滚。主动迭代新需求归 spec-start / spec-update，不要被笼统的'帮我做个开发任务'带走。

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/condition-based-waiting.md`, `references/defense-in-depth.md` and `references/root-cause-tracing.md`).

Example prompts

“帮我做个开发任务”
“/spec-debug”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

根因优先：没有验证过的根因，不改代码。先写下单一可证伪的假设，再设计能推翻它的最小实验，跑完再判断。一次改五处会让你不知道哪处起了作用
不修改已确认的 writer/plan.html：通过创建 debug 文档记录问题，保持设计的可追溯性
闭环协作：接收 TeamLead 转交的 bug handoff → 修复 → 向 TeamLead 请求重新验证
诊断确认随模式：gated 模式下创建 debug-xxx.html 后由 TeamLead 向用户确认诊断；autopilot 模式下由「单一可证伪假设 + 已跑过的最小实验输出」替代该确认——没有实验输出就不算确认通过
受预算约束：修复循环受 lead/team-context.md 的「修复循环预算」约束。每轮修复后必须更新「已用轮数」和「连续无进展」，触发上限时停止并交还 TeamLead，不自行无限重试

What it can do on your machine

Read from SKILL.md and the folder at commit a2cccf6. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- bash
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spec Debug loads about 2.6k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 409 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~113
When it runs · the whole SKILL.md, loaded when a task matches: ~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 409 words (~2,580 tokens).

name: spec-debug
disable-model-invocation: true

Outline of SKILL.md

Spec Debug
运行契约
核心原则
协作闭环
工作流程
步骤 1：接力 AWR 会话并收集问题信息
步骤 2：检索历史经验
步骤 3：复现并定位问题
步骤 4：分析根因
步骤 5：创建 debug-xxx.html 诊断文档
步骤 6：通知 TeamLead 等待用户确认诊断
步骤 7：检查修复循环预算
步骤 8：执行修复
步骤 9：创建 debug-xxx-fix.html 修复总结
步骤 10：更新修复循环记账
步骤 11：向 TeamLead 提交重新验证请求
与其他角色的协作
后续动作
常见陷阱

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (references) in spec-debug of HHU3637kr/skills.

SKILL.md
references/condition-based-waiting.md
references/debug-template.html
references/defense-in-depth.md
references/root-cause-tracing.md

Open the folder on GitHubat commit a2cccf6

Compare with similar skills

Spec Debug next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spec Debug compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Spec Debug this skillHHU3637kr/skills	145	—	~2.6k	Automated safety check: Pass	None	15 days ago
Debugasgeirtj/system_prompts_leaks	69k	—	~439	Automated safety check: Pass	CC0-1.0	today
Debuggerdavila7/claude-code-templates	32k	8 repos	~334	Automated safety check: Pass	MIT	today
Openclaw Debuggingopenclaw/openclaw	392k	—	~1.9k	Automated safety check: Pass	MIT	today
Debugging Executionsn8n-io/n8n	207k	—	~2.6k	Automated safety check: Pass	Custom licence	today
Debugging Toolkitsickn33/agentic-awesome-skills	47k	1 repos	~344	Automated safety check: Pass	MIT	today

Similar skills

Debug
asgeirtj/system_prompts_leaks
Enable debug logging for this session and help diagnose issues
69k GitHub stars~439 tokensUpdated today
Auto-check passed
Debugger
davila7/claude-code-templates
Debugging specialist for errors, test failures, and unexpected behavior.
32k GitHub starsUsed in 8 repos~334 tokens
DevelopmentAuto-check passed
Openclaw Debugging
openclaw/openclaw
Debug OpenClaw model, provider, tool-surface, code-mode, streaming, and live/Crabbox behavior by choosing the right logs, probes, and proof path before changing code, including fetching stored…
392k GitHub stars~1.9k tokensUpdated today
DevelopmentAuto-check passed
Debugging Executions
n8n-io/n8n
Official
Debug failed or wrong-output workflow executions using executions tools.
207k GitHub stars~2.6k tokensUpdated today
DevelopmentAuto-check passed
Debugging Toolkit
sickn33/agentic-awesome-skills
A skill your agent uses when working with debugging toolkit smart debug (Alias for debugging-toolkit-smart-debug)
47k GitHub starsUsed in 1 repo~344 tokens
DevelopmentAuto-check passed
Runtime Debug
vercel/next.js
Official
Debug and verification workflow for runtime-bundle and module-resolution regressions.
143k GitHub starsUsed in 1 repo~618 tokens
DevelopmentAuto-check passed

Questions about Spec Debug

What does Spec Debug do?

How do I install Spec Debug in Claude Code?

Run `npx skills add HHU3637kr/skills --skill spec-debug -a claude-code`. Or copy the skill folder (spec-debug in HHU3637kr/skills) into .claude/skills/spec-debug in your project. Claude Code loads it when a task matches its description.

How do I install Spec Debug in Codex?

Run `npx skills add HHU3637kr/skills --skill spec-debug -a codex`. Or copy the skill folder (spec-debug in HHU3637kr/skills) into .agents/skills/spec-debug in your project. Codex loads it when a task matches its description.

Can I use Spec Debug in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HHU3637kr/skills --skill spec-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spec-debug, .gemini/skills/spec-debug, .github/skills/spec-debug and .opencode/skills/spec-debug in your project.

What does Spec Debug need to run?

Going by SKILL.md and its folder, Spec Debug needs the command-line tools its instructions call (bash).

Does Spec Debug access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Spec Debug safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spec Debug use?

No licence was found for Spec Debug or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Spec Debug use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.4k tokens, read only when the agent opens those files.

What are the alternatives to Spec Debug?

Skills that share tags, products or a category with Spec Debug: Debug (asgeirtj/system_prompts_leaks, 69k stars), Debugger (davila7/claude-code-templates, 32k stars), Openclaw Debugging (openclaw/openclaw, 392k stars) and Debugging Executions (n8n-io/n8n, 207k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spec Debug?

HHU3637kr (a GitHub user) maintains it in HHU3637kr/skills, which has 145 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on September 23, 2026.

Source: HHU3637kr/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Spec Debug

Install Spec Debug

Facts

At a glance

What it does

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Debug

Debugger

Openclaw Debugging

Debugging Executions

Debugging Toolkit

Runtime Debug

More from HHU3637kr/skills

Gif Sticker Maker

Agent Browser

Darwin Skill

Token Efficiency

Guizang Ppt Skill

Huashu Nuwa

Questions about Spec Debug