Agent skill

Dev Debug

by classmethod in classmethod/tsumiki

This skill should be used when the user asks to "dev-debug", "テストが失敗する", "ビルドエラーを直して", "デバッグ", "debug failing tests", "fix build error", "エラーを修正", "コンパイルエラー", "環境の問題を解決".

MITAuto-check passedDevelopment

Install Dev Debug

skills CLI
$ npx skills add classmethod/tsumiki --skill dev-debug -a claude-code

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

GitHub CLI
$ gh skill install classmethod/tsumiki dev-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/classmethod/tsumiki.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dev-debug .claude/skills/dev-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/

Facts

Skill name
dev-debug
GitHub stars
974
Token cost
~1.6k tokens
SKILL.md length
387 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when the user asks to "dev-debug", "テストが失敗する", "ビルドエラーを直して", "デバッグ", "debug failing tests", "fix build error", "エラーを修正", "コンパイルエラー", "環境の問題を解決".

  • Works in 4 steps: エラー情報の収集と分類 → カテゴリ別診断 → 修正の適用と検証 → …
  • Asks to dev-debug
  • SKILL.md covers 前提知識, エラーカテゴリと対応戦略, ワークフロー and サイクル制限と escalation, plus 2 more sections
  • Calls git

What it does

Dev Debug is an agent skill from classmethod/tsumiki. This skill should be used when the user asks to "dev-debug", "テストが失敗する", "ビルドエラーを直して", "デバッグ", "debug failing tests", "fix build error", "エラーを修正", "コンパイルエラー", "環境の問題を解決". テスト失敗、ビルドエラー、環境問題など様々なエラーパターンをカテゴリ別に診断し、最小コンテキストで修正する。

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Failing and flaky tests and Linting and formatting. The licence is MIT.

When your agent uses it

  • Asks to dev-debug
  • Debug failing tests
  • Fix build error

Example prompts

  • “dev-debug”
  • “テストが失敗する”
  • “ビルドエラーを直して”
  • “/dev-debug”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. エラー情報の収集と分類
  2. カテゴリ別診断
  3. 修正の適用と検証
  4. 回帰テストと報告

What it can do on your machine

Read from SKILL.md and the folder at commit fa5aaff. 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:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Dev Debug loads about 1.6k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 387 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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

The full file from classmethod/tsumiki at commit fa5aaff, republished under its MIT licence (© classmethod). 387 words, ~1,645 tokens.

Download SKILL.mdSave it as .claude/skills/dev-debug/SKILL.md (or your agent's skills folder).
name
dev-debug
description
This skill should be used when the user asks to "dev-debug", "テストが失敗する", "ビルドエラーを直して", "デバッグ", "debug failing tests", "fix build error", "エラーを修正", "コンパイルエラー", "環境の問題を解決". テスト失敗、ビルドエラー、環境問題など様々なエラーパターンをカテゴリ別に診断し、最小コンテキストで修正する。
argument-hint
<error description>

Dev Debug

テスト失敗、コンパイルエラー、環境問題など、様々なエラーパターンに対応する集中デバッグスキル。エラーをカテゴリ分類し、それぞれに最適な診断・修正戦略を適用する。最小コンテキストでの高速解決を目指す。

前提知識

dev-*スキルフロー内の位置
dev-context → dev-plan → dev-impl → dev-verify
                              ↘ [dev-debug] ↗
                                     ↑
                              dev-webtest → [dev-debug webtest] → 「/dev-webtest retest で再テストしてください」
                                     ↑                                            │
                                     └──────── retest ────────────────────────────┘

dev-impl で解消できないエラーが発生した場合、dev-verify で問題が検出された場合、または dev-webtest で検出された画面系エラーの修正に使用する。

引数フォーマット
/dev-debug                           # 自動検出モード
/dev-debug "エラーメッセージや状況の説明"  # 手動指定モード
/dev-debug webtest                   # webtest エラー修正モード

エラーカテゴリと対応戦略

カテゴリ一覧
カテゴリ例診断アプローチ典型的な修正
コンパイル/型エラー型不一致、missing import、構文エラーエラーメッセージの直接分析型定義修正、import追加
テスト失敗assertion失敗、タイムアウト期待値と実際の差分分析ロジック修正 or テスト修正
ランタイムエラーnull参照、パニック、未処理例外スタックトレース分析エラーハンドリング追加
環境・設定依存関係エラー、設定ミス、パス問題設定ファイル・環境変数チェック設定修正、依存追加
Lint/フォーマットスタイル違反、未使用変数Lint出力分析自動修正 or コード調整
依存関係バージョン競合、パッケージ不足lock file/パッケージ分析バージョン調整、パッケージ追加
webtest エラー視覚崩れ、a11y違反、レスポンシブ不備、フォームバリデーション不備、シナリオ失敗error.md の検出内容・再現手順を分析CSS/HTML修正、バリデーション追加、機能バグ修正

ワークフロー

Step 1: エラー情報の収集と分類
自動検出モード(引数なし)
  1. docs/dev/context.md からテスト実行コマンドを取得する
  2. テストを実行してエラーを収集する
  3. ビルドコマンドがある場合はビルドも実行する
手動指定モード(引数あり、webtest 以外)

ユーザーが提供したエラー情報を分析する。

webtest モード(引数が webtest)
  1. docs/dev/webtests/errors/ を Glob で走査し、全 error.md を取得する
  2. 各 error.md を Read し、frontmatter の status: open のものだけ収集する
  3. 0件の場合 →「未解決の webtest エラーはありません」と報告して終了
  4. severity 順にソートする(critical → major → minor)
  5. 各エラーを Step 2 の webtest エラー診断 → Step 3 の修正・検証で順次処理する
  6. 全エラー処理後、Step 4 で報告する(/dev-webtest retest での再テストを案内)
分類判定

エラーメッセージのパターンマッチでカテゴリを判定する:

  • TypeError, SyntaxError, Cannot find module, missing import → コンパイル/型エラー
  • AssertionError, expect(, assert, test failed → テスト失敗
  • null, undefined, panic, NullPointerException, segfault → ランタイムエラー
  • ENOENT, Permission denied, port already in use, env → 環境・設定
  • eslint, prettier, clippy, unused variable → Lint/フォーマット
  • ERESOLVE, version conflict, peer dependency → 依存関係
Step 2: カテゴリ別診断
コンパイル/型エラー

最小コンテキスト: エラー箇所のファイルのみ読み込む。

  1. エラーメッセージから該当ファイルと行番号を特定する
  2. 該当ファイルの関連部分を読み込む(Read tool の offset/limit を活用)
  3. 型定義・インターフェースが関係する場合はそれも読み込む
  4. 修正案を生成する
テスト失敗

最小コンテキスト: テストファイル + 対象実装ファイル。

  1. 失敗テストのファイルと名称を特定する
  2. テストファイルを読み込み、期待値を確認する
  3. 対象の実装ファイルを読み込む
  4. 期待値と実際の差分から原因を特定する
  5. 判断: テストが正しいか、実装が正しいかを判断する
    • テストが正しい場合 → 実装を修正
    • 実装が正しい場合 → テストを修正(ユーザーに確認を推奨)
ランタイムエラー

最小コンテキスト: スタックトレースに含まれるファイル。

  1. スタックトレースからコールチェーンを特定する
  2. 最も関連性の高いファイルから読み込む
  3. null/undefined チェックの漏れ、例外ハンドリングの不足を特定する
  4. ガード句やエラーハンドリングを追加する
環境・設定

最小コンテキスト: 設定ファイル群。

  1. Explore サブエージェント(haiku)で設定ファイルを探索する
  2. 環境変数、パス設定、ポート設定等を確認する
  3. 必要に応じてユーザーに手動操作を依頼する(AskUserQuestion)
  4. AI単独で解決できない場合は明確に伝達する
Lint/フォーマット

最小コンテキスト: Lint出力のみ。

  1. Lint/フォーマッターの自動修正コマンドがあれば実行する
  2. 自動修正できない場合は手動で修正する
  3. 修正後に再度Lintを実行して確認する
Show full SKILL.md (160 more words)Show less
依存関係

最小コンテキスト: パッケージ定義ファイル + lock file。

  1. パッケージマネージャのエラー出力を分析する
  2. 依存ツリーの競合を確認する
  3. 互換性のあるバージョンを提案する
  4. 必要に応じてユーザーに確認する(破壊的変更がある場合)
webtest エラー

最小コンテキスト: error.md + 関連するソースファイル。

error.md の step フィールドに応じて診断アプローチを切り替える:

step主な修正対象診断アプローチ
3-visualCSS、テンプレートerror.md の検出内容からレイアウト崩れの原因を特定し、CSS/テンプレートを修正
4-a11yHTML属性不足している alt、label、aria 属性、heading 階層を特定して追加
5-responsiveメディアクエリ、CSS問題のビューポートサイズに対応するメディアクエリやレイアウト CSS を修正
6-formバリデーションロジックサーバー/クライアントのバリデーション処理を特定して修正。XSS/SQLi はサニタイズ処理を追加
2a-scenario / 2b-monkey機能実装再現手順と期待される状態から機能バグを特定し、実装を修正
  1. error.md の「検出内容」「再現手順」「期待される状態」を読み取る
  2. Explore サブエージェント(haiku)で関連ソースファイルを特定する
  3. 上記テーブルに従い修正案を生成する
  4. 修正を適用する(Step 3 へ進む)
Step 3: 修正の適用と検証
  1. 修正案を適用する
  2. カテゴリに応じた検証コマンドを実行する:
    • コンパイル/型エラー → ビルド実行
    • テスト失敗 → 失敗していたテストを実行
    • ランタイムエラー → 関連テストを実行
    • 環境・設定 → 環境チェックコマンド
    • Lint → Lint再実行
    • 依存関係 → インストール + ビルド
  3. 修正が不十分な場合は Step 2 に戻る(最大3サイクル)
Step 4: 回帰テストと報告
  1. 修正対象のエラーが解消されたことを確認する
  2. 全テストを実行し、回帰がないことを確認する
  3. 結果をユーザーに報告する

報告フォーマット(通常モード):

markdown
## dev-debug 結果

### 検出されたエラー
- カテゴリ: [エラーカテゴリ]
- 原因: [根本原因の説明]

### 適用した修正
- [ファイル](パス): [修正内容]

### 検証結果
- 対象エラー: 解消
- 回帰テスト: passed / failed

### 確信度
- 🔵/🟡/🔴: [修正の確信度と理由]

報告フォーマット(webtest モード):

markdown
## dev-debug webtest 結果

### 修正したエラー
| # | error.md | severity | step | 修正内容 |
|---|----------|----------|------|---------|
| 1 | docs/dev/webtests/errors/.../ | critical | 2a-scenario | [修正内容] |

### 修正できなかったエラー
| # | error.md | severity | step | 理由 |
|---|----------|----------|------|------|
(なければ「なし」)

### 次のステップ
`/dev-webtest retest` で再テストし、修正が反映されているか確認してください。

サイクル制限と escalation

3サイクルで解決できない場合:

  1. これまでの診断結果と試行した修正をユーザーに報告する
  2. 考えられる追加の原因仮説を提示する
  3. ユーザーに次のアクションを相談する(AskUserQuestion):
    • 追加情報の提供
    • 手動での確認依頼
    • アプローチの変更

Intent コメントルール

コード修正時に、既存の Intent コメント(🔵🟡🔴)を維持し、修正箇所には適切に追加・更新する。

修正時の対応
  • 既存の Intent コメントがある関数を修正する場合: コメント内容が修正後も正確であれば維持する。修正により意図が変わった場合はコメントを更新する
  • 新しい関数・メソッドを追加する場合: dev-impl と同じルールで Intent コメントを付与する(public 関数は必須)
  • デバッグ修正特有の判断がある場合: 修正理由を Intent コメントに反映する
go
// 🟡 Intent: nil チェックを追加。元のコードではリポジトリが nil を返すケースが
//    未考慮だったため、エラーとして返却するガード句を追加。
func (s *TodoService) GetByID(ctx context.Context, id string) (*model.Todo, error) {
信号機の判定基準
  • 🔵 前工程指示: タスクファイル・plan.md で指示された修正
  • 🟡 妥当な推測: エラーパターンから推論した妥当な修正(ガード句追加、型修正等)
  • 🔴 AI推論補完: 根本原因が不明確なまま適用した暫定修正

ルール・制約

  • 最小コンテキスト原則: エラーに関連するファイルだけ読み込む。プロジェクト全体を読まない
  • サイクル制限: 修正→検証のサイクルは最大3回
  • 回帰防止: 修正後は必ず全テストを実行する
  • 環境問題の限界認識: AI単独で解決できない環境問題(OS設定、ネットワーク等)はユーザーに明示的に伝達する
  • テスト修正の慎重さ: テストを修正する場合はユーザーに確認を推奨する(テストが仕様を反映しているため)
  • 探索作業は Explore サブエージェント(haiku)に委託し、メインコンテキストを保護する
  • 500行ルール: 修正によりファイルが500行を超える場合は分割する
  • Bash コマンドはプロジェクトルートの 絶対パス を使用する($(git rev-parse --show-toplevel) でルートを取得)

© classmethod, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/dev-debug of classmethod/tsumiki.

Open the folder on GitHubat commit fa5aaff

Compare with similar skills

Dev 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.

Dev Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dev Debug this skillclassmethod/tsumiki974—~1.6kAutomated safety check: PassMIT
FixBUZZARDGTA/Session-Sniffer104—~2.7kAutomated safety check: PassGPL-3.0
Maintainer Personamizchi/skills356—~6.4kAutomated safety check: PassNone
Omh Build Failure Triagerlaope/oh-my-hermes3.2k—~2.3kAutomated safety check: PassMIT
Validate Fixdanielvm-git/bigpowers256—~1.1kAutomated safety check: PassMIT
Babysit PRZenUml/web-sequence150—~871Automated safety check: PassMIT

Similar skills

  • Fix

    BUZZARDGTA/Session-Sniffer

    Diagnose and fix Session Sniffer bugs, errors, tracebacks, logs, lint failures, static-analysis findings, test failures, and IDE-reported problems.

    104 GitHub stars~2.7k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Maintainer Persona

    mizchi/skills

    Write an issue or PR for a repository you do not own so its maintainers can triage it.

    356 GitHub stars~6.4k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Omh Build Failure Triage

    rlaope/oh-my-hermes

    [omh] Build or CI failure to triage: classify build, typecheck, lint, test, CI, and DCO failures into minimal safe fix handoffs.

    3.2k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Validate Fix

    danielvm-git/bigpowers

    Prove a fix works before declaring done — re-run the failing test, run the full suite, typecheck, lint, and harden against recurrence.

    256 GitHub stars~1.1k tokensUpdated 15 days ago
    DevelopmentAuto-check passed
  • Babysit PR

    ZenUml/web-sequence

    Monitor and diagnose GitHub Actions checks on ZenUML web-sequence PRs, fixing code-caused CI failures when appropriate.

    150 GitHub stars~871 tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Debug CI

    web-infra-dev/rslint

    Reproduce Linux CI failures locally using Docker when the same tests pass on the host, especially Go platform differences and VS Code extension tests requiring xvfb.

    460 GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed

More from classmethod/tsumiki

All 14 skills in this repo
  • Dev Context

    classmethod/tsumiki

    This skill should be used when the user asks to "dev-context", "プロジェクトコンテキストを生成", "プロジェクトを分析", "generate project context", "analyze project", "コンテキストを更新".

    974 GitHub stars~755 tokensUpdated 2 mo ago
    Auto-check passed
  • Dev Impl

    classmethod/tsumiki

    This skill should be used when the user asks to "dev-impl", "タスクを実装", "テストファースト実装", "implement task", "実装を開始", "クイック修正", "quick fix", "dev-impl auth 001".

    974 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Dev Plan

    classmethod/tsumiki

    This skill should be used when the user asks to "dev-plan", "実装計画を作成", "要件からタスク分解", "create implementation plan", "plan tasks", "タスクを分割", "設計してタスクにする", "詳細要件定義", "full-spec plan", "EARS要件".

    974 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Dev Run

    classmethod/tsumiki

    This skill should be used when the user asks to "dev-run", "自動実装", "タスクを一括実装", "auto implement", "run all tasks", "タスクを自動実行", "バッチ実装", "dev-run auth 001 005".

    974 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Dev Screen Spec

    classmethod/tsumiki

    This skill should be used when the user asks to "dev-screen-spec", "画面仕様を生成", "画面仕様を更新", "screen spec", "generate screen spec", "update screen spec", "画面仕様ドキュメント".

    974 GitHub stars~4.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Dev Webtest

    classmethod/tsumiki

    This skill should be used when the user asks to "dev-webtest", "Webテスト", "画面の動作確認", "E2Eテスト", "web test", "visual check", "モンキーテスト", "アクセシビリティチェック", "レスポンシブテスト", "フォームテスト".

    974 GitHub stars~4.2k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Dev Debug

What does Dev Debug do?

This skill should be used when the user asks to "dev-debug", "テストが失敗する", "ビルドエラーを直して", "デバッグ", "debug failing tests", "fix build error", "エラーを修正", "コンパイルエラー", "環境の問題を解決". Dev Debug is an agent skill from classmethod/tsumiki. This skill should be used when the user asks to "dev-debug", "テストが失敗する", "ビルドエラーを直して", "デバッグ", "debug failing tests", "fix build error", "エラーを修正", "コンパイルエラー", "環境の問題を解決".

When should I use Dev Debug?

Dev Debug fits situations like: asks to dev-debug; debug failing tests; fix build error.

How do I install Dev Debug in Claude Code?

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

How do I install Dev Debug in Codex?

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

Can I use Dev 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 classmethod/tsumiki --skill dev-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/dev-debug, .gemini/skills/dev-debug, .github/skills/dev-debug and .opencode/skills/dev-debug in your project.

What does Dev Debug need to run?

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

Does Dev Debug access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Dev 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 Dev Debug use?

Dev Debug is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dev Debug use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dev Debug?

Skills that share tags, products or a category with Dev Debug: Fix (BUZZARDGTA/Session-Sniffer, 104 stars), Maintainer Persona (mizchi/skills, 356 stars), Omh Build Failure Triage (rlaope/oh-my-hermes, 3.2k stars) and Validate Fix (danielvm-git/bigpowers, 256 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dev Debug?

classmethod (a GitHub organization) maintains it in classmethod/tsumiki, which has 974 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on August 7, 2026.

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