スキル claude-code-debug
📦

claude-code-debug

コンテンツリビジョン r1 高リスク ⚙️ 外部コマンド📁 ファイルシステムへのアクセス🔑 環境変数🌐 ネットワークアクセス

Claude Code拡張機能の問題をデバッグする

Claude Code拡張機能は、ファイルレイアウト、frontmatter、権限、hook、agent、またはMCP構成が原因で失敗することがあります。このskillは、原因を切り分けるための実践的な診断フローとコマンドリファレンスを提供します。

対応: Claude Codex Code(CC)
⚠️ 38 不十分

自分のエージェントでインストール

このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。

エージェントリクエスト
Review the Skillstore skill "claude-code-debug" from https://skillstore.io/skills/0xdarkmatter-claude-code-debug.md and its manifest at https://skillstore.io/api/skills/0xdarkmatter-claude-code-debug/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。

エージェントが読めるリソース

AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。

Markdown詳細 GET /skills/0xdarkmatter-claude-code-debug.md 署名済み manifest GET /api/skills/0xdarkmatter-claude-code-debug/manifest 署名済み lockfile GET /api/skills/0xdarkmatter-claude-code-debug/lockfile

テストする

「claude-code-debug」を使用しています。 My hook appears in settings but never blocks a tool call.

期待される結果:

  • hookが正確なtool名とevent typeに対して登録されていることを確認します。
  • scriptが実行可能であり、standard inputからサンプル入力を読み取れることを確認します。
  • ブロック動作が期待されるexit codeを使用し、messageを正しいstreamに書き込んでいることを検証します。

「claude-code-debug」を使用しています。 My custom agent file exists, but Claude Code never selects it.

期待される結果:

  • agentファイルが、サポートされているユーザーまたはプロジェクトのagentディレクトリにあることを確認します。
  • frontmatterのnameとdescriptionに明確な使用シグナルがあるか確認します。
  • 委任をテストする前に、agent list viewを使用して検出を確認します。

「claude-code-debug」を使用しています。 An MCP server is configured, but its tools do not appear.

期待される結果:

  • server packageがClaude Codeの外部で起動できるかテストします。
  • transport settingsと参照されている環境変数を確認します。
  • permission rulesが想定されるMCP tool名を許可していることを確認します。

セキュリティ監査

高リスク
v6 • 2026/7/4 バージョン別レポートを開く

This skill is a documentation-only troubleshooting aid for Claude Code extensions. Most static findings are false positives from Markdown examples, local Claude path references, and official documentation links. Confirmed risks remain where the references tell users to display token values or print Claude session logs.

4
スキャンされたファイル
823
解析済み行数
5
レビュー項目
0
誤検知を無視

確認済みのセキュリティ上の懸念 (2)

高
references/common-issues.md:137references/debug-commands.md:240-241
Sensitive Token Display Guidance
The debugging references instruct users to echo GitHub and Anthropic API token values. This can leak credentials into terminals, logs, copied bug reports, or chat transcripts.
The cited commands explicitly display token material, so the risk is semantic and intentional, not only a variable-name match.
高
references/debug-commands.md:227-231
Sensitive Session Log Disclosure Guidance
The debug commands tell users to print the most recent Claude session file. Session logs can contain prompts, tool outputs, local paths, and secret values.
The command directly reads the latest file from the Claude sessions directory and prints it, which confirms session content disclosure risk.
機能レビュー項目 (5)

これらは、このスキルに期待される可能性のある実際のローカル機能であるため、レビューが必要ですが、確認済みの悪意ある動作としてはカウントされません。

高
references/common-issues.md:137
Git platform tokens
echo $GITHUB_TOKEN
The documentation tells the user to print GITHUB_TOKEN directly. That can expose a GitHub credential in terminal output, logs, or copied diagnostics.
高
references/debug-commands.md:231
Shell command substitution
cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)
The command substitution selects a session file and prints it with cat. This is a documentation example, but it can expose private Claude session content and should use safer filtering or redaction.
高
references/debug-commands.md:231
Hidden file in home directory
cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)
The example reads a file under the user home Claude sessions directory. Session files can contain prompts, outputs, paths, and secrets, so displaying them is a real privacy risk.
高
references/debug-commands.md:231
Hidden file access
cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)
The example reads hidden Claude session data from the user home directory. This goes beyond a harmless path reference because it prints private session contents.
高
references/debug-commands.md:241
Generic API/secret keys
echo ${ANTHROPIC_API_KEY:0:10}...
The command displays the first characters of ANTHROPIC_API_KEY. Even partial API key disclosure is unnecessary for troubleshooting and can leak credential material.

リスク要因

⚙️ 外部コマンド (20)
references/common-issues.md:26 references/debug-commands.md:231 SKILL.md:16-25 SKILL.md:25-32 SKILL.md:32 SKILL.md:34-39 SKILL.md:39-47 SKILL.md:47-53 SKILL.md:53-64 SKILL.md:64-68 SKILL.md:68-78 SKILL.md:78-82 SKILL.md:82-92 SKILL.md:92-96 SKILL.md:96-105 SKILL.md:105-116 SKILL.md:116-117 SKILL.md:117-118 SKILL.md:118-122 SKILL.md:122
📁 ファイルシステムへのアクセス (46)
references/common-issues.md:13 references/common-issues.md:60 references/common-issues.md:89 references/common-issues.md:99 references/common-issues.md:191 references/common-issues.md:203 references/common-issues.md:13 references/common-issues.md:60 references/common-issues.md:89 references/common-issues.md:99 references/common-issues.md:154 references/common-issues.md:191 references/common-issues.md:203 references/common-issues.md:164 references/common-issues.md:194 references/debug-commands.md:82 references/debug-commands.md:137 references/debug-commands.md:141 references/debug-commands.md:145 references/debug-commands.md:149 references/debug-commands.md:159 references/debug-commands.md:228 references/debug-commands.md:231 references/debug-commands.md:82 references/debug-commands.md:84 references/debug-commands.md:109 references/debug-commands.md:110 references/debug-commands.md:137 references/debug-commands.md:141 references/debug-commands.md:145 references/debug-commands.md:149 references/debug-commands.md:159 references/debug-commands.md:228 references/debug-commands.md:231 references/troubleshooting-flow.md:91 references/troubleshooting-flow.md:121 references/troubleshooting-flow.md:173 references/troubleshooting-flow.md:179 references/troubleshooting-flow.md:91 references/troubleshooting-flow.md:121 references/troubleshooting-flow.md:173 references/troubleshooting-flow.md:179 SKILL.md:77 SKILL.md:84 SKILL.md:77 SKILL.md:84
🔑 環境変数 (2)
references/common-issues.md:137 references/debug-commands.md:241
🌐 ネットワークアクセス (4)
SKILL.md:109 SKILL.md:110 SKILL.md:111 SKILL.md:112
監査者: codex 監査履歴を表示 →
このレポートを共有・引用

バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。

バージョン別レポートを開く
セキュリティ評価

レポートリンクをコピー

https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdownバッジ

[![Skillstore security assessment](https://skillstore.io/badges/skills/0xdarkmatter-claude-code-debug/security.svg)](https://skillstore.io/skills/0xdarkmatter-claude-code-debug?utm_source=security_passport_badge)

HTMLバッジ

<a href="https://skillstore.io/skills/0xdarkmatter-claude-code-debug?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/0xdarkmatter-claude-code-debug/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

埋め込みカード

<iframe src="https://skillstore.io/embed/skills/0xdarkmatter-claude-code-debug.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学術引用 (APA · BibTeX · CFF)

APA形式の引用

0xDarkMatter. (2026). claude-code-debug security audit report (audit version 6) [Author version unspecified]. Skillstore. https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6

BibTeX形式の引用

@techreport{0xdarkmatter-0xdarkmatter-claude-code-debug-2026, author = {0xDarkMatter}, title = {claude-code-debug security audit report (audit version 6)}, institution = {Skillstore}, year = {2026}, number = {6}, url = {https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "claude-code-debug security audit report (audit version 6)" version: "unspecified" type: report authors: - name: "0xDarkMatter" date-released: "2026-07-04" url: "https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6" identifiers: - type: other value: "skillstore:0xdarkmatter-claude-code-debug:audit:6" description: "Skillstore immutable audit report identifier"

Skillstore スコア

このスコアの理由 証拠の信頼度: 中
45
アーキテクチャ
85
保守性
87
コンテンツ
73
コミュニティ
91
仕様準拠

作成できるもの

Skillの有効化を修正する

構造、metadata、trigger wordingを確認して、Claude Code skillが読み込まれない、または有効化されない理由を特定します。

Hookの失敗を追跡する

PreToolUseまたはPostToolUse hookが見つからない、実行可能でない、一致しない、または誤ったexit codeを返す理由を特定します。

AgentとMCP設定を検証する

Claude Code toolsが利用できない、または不安定な場合に、custom agentの可視性とMCP server登録を確認します。

これらのプロンプトを試す

読み込まれないSkillを確認する 
Debug my Claude Code skill. The skill name is [name], it is located at [path], and the symptom is [what happens]. Start with file structure and frontmatter checks.
Hookが実行されない理由を特定する 
Troubleshoot my Claude Code hook. The hook type is [PreToolUse or PostToolUse], the matcher is [matcher], and the script path is [path]. Check registration, permissions, input, and exit behavior.
AgentまたはMCPの検出を診断する 
Help diagnose why my Claude Code agent or MCP server is not available. Review the expected location, metadata, configuration entry, transport, and environment variable references.
拡張機能設定全体を監査する 
Create a diagnostic plan for my Claude Code setup. It includes skills, hooks, agents, MCP servers, and project settings. Prioritize checks that isolate loading, permission, and configuration failures.

ベストプラクティス

  • 診断出力を共有する前に、token、secret、ローカルパス、セッション内容を編集します。
  • 意図したプロジェクトルートから確認を実行し、ユーザーレベルの構成を調査する前にscopeを確認します。
  • Claude Code debug outputから始め、その後、構造、権限、metadataの順に検証します。

回避

  • 完全なAPI tokenを表示したり、生のセッションログをchat、issue、またはsupport requestに貼り付けたりすること。
  • deny rules、hook matchers、正確なcommand patternsを確認する前に、tool permissionsを広げること。
  • filename、directory location、frontmatter syntaxを検証する前に、拡張機能が読み込まれたと想定すること。

よくある質問

このskillはどのような問題のデバッグに役立ちますか？
Claude Code skills、hooks、agents、MCP servers、settings、permissions、および関連する拡張機能の読み込み動作のデバッグに役立ちます。
これは私のClaude Code構成を変更しますか？
このskillは診断手順を提供します。構成変更は別途確認し、承認する必要があります。
global Claude settingsを調査できますか？
一部の例では、ユーザーレベルのClaude settingsを調査します。マシン外に共有する前に、出力を確認して編集してください。
デバッグ中にAPI keysを表示しても安全ですか？
いいえ。完全または部分的なAPI keyを表示する代わりに、存在確認や編集済みの値を使用してください。
MCP serverの失敗に役立ちますか？
はい。package checks、configuration entries、transport settings、environment references、tool permissionsを扱います。
公式のClaude Codeドキュメントの代わりになりますか？
いいえ。トラブルシューティング手順を整理し、より詳しい参照のために公式ドキュメントへリンクします。

開発者情報

作成者

0xDarkMatter

ライセンス

MIT

Skillstore リビジョン

r1

バージョンに関する注意

作者はバージョンを宣言していません。

リポジトリ

https://github.com/0xDarkMatter/claude-mods/tree/main/skills/claude-code-debug

参照

b94843b1014e2052f8a7cd64f580a4023b48fd5f

メンテナンスの新しさ

2026/7/18

利用状況

6 ダウンロード · 389 閲覧

ファイル構成

📁 references/

📄 common-issues.md

📄 debug-commands.md

📄 troubleshooting-flow.md

📄 SKILL.md

0xDarkMatter のその他のスキル

すべて表示

関連スキル

すべて表示