Skip to content

aiskillstore/marketplace / skills/0xdarkmatter/claude-code-debug

claude-code-debug

Verified

Troubleshoot Claude Code extensions and behavior. Triggers on: debug, troubleshoot, not working, skill not loading, hook not running, agent not found.

FileKindSize
SKILL.mdskill md2.7 KB
references/common-issues.mdmarkdown5.4 KB
references/debug-commands.mdmarkdown4.4 KB
references/troubleshooting-flow.mdmarkdown7.9 KB
skill-report.jsonconfig79.3 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T16:44:05.652Z",
    "slug": "0xdarkmatter-claude-code-debug",
    "source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/claude-code-debug",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "5bf74c6f0a615003c127f6918ed0cdee7ae98b67056dc6541f9a5b1848a1759b",
    "tree_hash": "460878e38fce0d5ce5ac6f74d2e6e11241d01f17809d2a413341a59497863df1",
    "provenance": {
      "model_requested": "gpt-5.5:high",
      "model_effective": "codex:gpt-5.5:high",
      "fallback_chain": [
        {
          "agent": "codex",
          "model": "gpt-5.5",
          "effort": "high",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "claude-code-debug",
    "description": "Troubleshoot Claude Code skills, hooks, agents, MCP servers, settings, and extension behavior with focused diagnostic steps.",
    "summary": "Debug Claude Code extension loading, hooks, agents, MCP setup, and local configuration issues.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "0xDarkMatter",
    "license": "MIT",
    "tags": [
      "claude-code",
      "debugging",
      "hooks",
      "agents",
      "mcp"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "filesystem",
      "env_access",
      "network"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "high",
    "is_blocked": false,
    "safe_to_publish": false,
    "analysis_status": "ok",
    "summary": "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.",
    "remediation": [
      {
        "issue": "Token display in diagnostic commands",
        "suggestion": "Replace token echo commands with presence-only checks that never reveal full or partial secret values.",
        "severity": "high"
      },
      {
        "issue": "Session log disclosure command",
        "suggestion": "Avoid printing full Claude session files. Recommend targeted local searches and require redaction before any output is shared.",
        "severity": "high"
      },
      {
        "issue": "Sensitive configuration inspection guidance",
        "suggestion": "Add warnings near settings and MCP checks to redact local paths, permissions, server names, and environment references before sharing output.",
        "severity": "medium"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "references/common-issues.md",
            "line_start": 26,
            "line_end": 26
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 231,
            "line_end": 231
          },
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 32,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 39
          },
          {
            "file": "SKILL.md",
            "line_start": 39,
            "line_end": 47
          },
          {
            "file": "SKILL.md",
            "line_start": 47,
            "line_end": 53
          },
          {
            "file": "SKILL.md",
            "line_start": 53,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 78
          },
          {
            "file": "SKILL.md",
            "line_start": 78,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 92
          },
          {
            "file": "SKILL.md",
            "line_start": 92,
            "line_end": 96
          },
          {
            "file": "SKILL.md",
            "line_start": 96,
            "line_end": 105
          },
          {
            "file": "SKILL.md",
            "line_start": 105,
            "line_end": 116
          },
          {
            "file": "SKILL.md",
            "line_start": 116,
            "line_end": 117
          },
          {
            "file": "SKILL.md",
            "line_start": 117,
            "line_end": 118
          },
          {
            "file": "SKILL.md",
            "line_start": 118,
            "line_end": 122
          },
          {
            "file": "SKILL.md",
            "line_start": 122,
            "line_end": 122
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "references/common-issues.md",
            "line_start": 13,
            "line_end": 13
          },
          {
            "file": "references/common-issues.md",
            "line_start": 60,
            "line_end": 60
          },
          {
            "file": "references/common-issues.md",
            "line_start": 89,
            "line_end": 89
          },
          {
            "file": "references/common-issues.md",
            "line_start": 99,
            "line_end": 99
          },
          {
            "file": "references/common-issues.md",
            "line_start": 191,
            "line_end": 191
          },
          {
            "file": "references/common-issues.md",
            "line_start": 203,
            "line_end": 203
          },
          {
            "file": "references/common-issues.md",
            "line_start": 13,
            "line_end": 13
          },
          {
            "file": "references/common-issues.md",
            "line_start": 60,
            "line_end": 60
          },
          {
            "file": "references/common-issues.md",
            "line_start": 89,
            "line_end": 89
          },
          {
            "file": "references/common-issues.md",
            "line_start": 99,
            "line_end": 99
          },
          {
            "file": "references/common-issues.md",
            "line_start": 154,
            "line_end": 154
          },
          {
            "file": "references/common-issues.md",
            "line_start": 191,
            "line_end": 191
          },
          {
            "file": "references/common-issues.md",
            "line_start": 203,
            "line_end": 203
          },
          {
            "file": "references/common-issues.md",
            "line_start": 164,
            "line_end": 164
          },
          {
            "file": "references/common-issues.md",
            "line_start": 194,
            "line_end": 194
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 82,
            "line_end": 82
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 137,
            "line_end": 137
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 141,
            "line_end": 141
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 145,
            "line_end": 145
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 149,
            "line_end": 149
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 159,
            "line_end": 159
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 228,
            "line_end": 228
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 231,
            "line_end": 231
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 82,
            "line_end": 82
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 84,
            "line_end": 84
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 109,
            "line_end": 109
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 110,
            "line_end": 110
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 137,
            "line_end": 137
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 141,
            "line_end": 141
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 145,
            "line_end": 145
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 149,
            "line_end": 149
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 159,
            "line_end": 159
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 228,
            "line_end": 228
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 231,
            "line_end": 231
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 91,
            "line_end": 91
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 121,
            "line_end": 121
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 173,
            "line_end": 173
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 179,
            "line_end": 179
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 91,
            "line_end": 91
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 121,
            "line_end": 121
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 173,
            "line_end": 173
          },
          {
            "file": "references/troubleshooting-flow.md",
            "line_start": 179,
            "line_end": 179
          },
          {
            "file": "SKILL.md",
            "line_start": 77,
            "line_end": 77
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 77,
            "line_end": 77
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 84
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "references/common-issues.md",
            "line_start": 137,
            "line_end": 137
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 241,
            "line_end": 241
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 109,
            "line_end": 109
          },
          {
            "file": "SKILL.md",
            "line_start": 110,
            "line_end": 110
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 112,
            "line_end": 112
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:references/common-issues.md:26:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/common-issues.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "dirname=$(basename \"$(pwd)\")"
      },
      {
        "id": "filesystem:references/common-issues.md:13:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/common-issues.md",
        "line_start": 13,
        "line_end": 13,
        "snippet": "| Wrong location | Must be `.claude/skills/name/SKILL.md` or `~/.claude/skills/name/SKILL.md` |"
      },
      {
        "id": "filesystem:references/common-issues.md:60:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/common-issues.md",
        "line_start": 60,
        "line_end": 60,
        "snippet": "jq '.' ~/.claude/settings.json"
      },
      {
        "id": "filesystem:references/common-issues.md:89:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/common-issues.md",
        "line_start": 89,
        "line_end": 89,
        "snippet": "| Wrong location | Must be `.claude/agents/name.md` or `~/.claude/agents/name.md` |"
      },
      {
        "id": "filesystem:references/common-issues.md:99:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/common-issues.md",
        "line_start": 99,
        "line_end": 99,
        "snippet": "ls ~/.claude/agents/"
      },
      {
        "id": "filesystem:references/common-issues.md:191:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/common-issues.md",
        "line_start": 191,
        "line_end": 191,
        "snippet": "cat ~/.claude/settings.json | jq '.permissions'"
      },
      {
        "id": "filesystem:references/common-issues.md:203:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/common-issues.md",
        "line_start": 203,
        "line_end": 203,
        "snippet": "2. **Check file locations**: `ls -la .claude/` and `ls -la ~/.claude/`"
      },
      {
        "id": "filesystem:references/common-issues.md:13:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/common-issues.md",
        "line_start": 13,
        "line_end": 13,
        "snippet": "| Wrong location | Must be `.claude/skills/name/SKILL.md` or `~/.claude/skills/name/SKILL.md` |"
      },
      {
        "id": "filesystem:references/common-issues.md:60:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/common-issues.md",
        "line_start": 60,
        "line_end": 60,
        "snippet": "jq '.' ~/.claude/settings.json"
      },
      {
        "id": "filesystem:references/common-issues.md:89:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/common-issues.md",
        "line_start": 89,
        "line_end": 89,
        "snippet": "| Wrong location | Must be `.claude/agents/name.md` or `~/.claude/agents/name.md` |"
      },
      {
        "id": "filesystem:references/common-issues.md:99:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/common-issues.md",
        "line_start": 99,
        "line_end": 99,
        "snippet": "ls ~/.claude/agents/"
      },
      {
        "id": "filesystem:references/common-issues.md:154:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/common-issues.md",
        "line_start": 154,
        "line_end": 154,
        "snippet": "| Wrong location | Must be `./CLAUDE.md` or `./.claude/CLAUDE.md` |"
      },
      {
        "id": "filesystem:references/common-issues.md:191:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/common-issues.md",
        "line_start": 191,
        "line_end": 191,
        "snippet": "cat ~/.claude/settings.json | jq '.permissions'"
      },
      {
        "id": "filesystem:references/common-issues.md:203:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/common-issues.md",
        "line_start": 203,
        "line_end": 203,
        "snippet": "2. **Check file locations**: `ls -la .claude/` and `ls -la ~/.claude/`"
      },
      {
        "id": "filesystem:references/common-issues.md:164:standard-device-file-access",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Standard device file access",
        "file": "references/common-issues.md",
        "line_start": 164,
        "line_end": 164,
        "snippet": "ls -la CLAUDE.md .claude/CLAUDE.md 2>/dev/null"
      },
      {
        "id": "filesystem:references/common-issues.md:194:standard-device-file-access",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Standard device file access",
        "file": "references/common-issues.md",
        "line_start": 194,
        "line_end": 194,
        "snippet": "cat .claude/settings.local.json | jq '.permissions' 2>/dev/null"
      },
      {
        "id": "env_access:references/common-issues.md:137:git-platform-tokens",
        "category": "env_access",
        "severity": "high",
        "pattern": "Git platform tokens",
        "file": "references/common-issues.md",
        "line_start": 137,
        "line_end": 137,
        "snippet": "echo $GITHUB_TOKEN"
      },
      {
        "id": "blocker:references/common-issues.md:45:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/common-issues.md",
        "line_start": 45,
        "line_end": 45,
        "snippet": "| Invalid JSON in settings | Validate with `jq '.' settings.json` |"
      },
      {
        "id": "blocker:references/common-issues.md:90:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/common-issues.md",
        "line_start": 90,
        "line_end": 90,
        "snippet": "| YAML invalid | Check frontmatter has `name:` and `description:` |"
      },
      {
        "id": "external_commands:references/debug-commands.md:231:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "references/debug-commands.md",
        "line_start": 231,
        "line_end": 231,
        "snippet": "cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)"
      },
      {
        "id": "filesystem:references/debug-commands.md:82:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 82,
        "line_end": 82,
        "snippet": "1. ~/.claude/CLAUDE.md (user)"
      },
      {
        "id": "filesystem:references/debug-commands.md:137:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 137,
        "line_end": 137,
        "snippet": "ls -la ~/.claude/skills/"
      },
      {
        "id": "filesystem:references/debug-commands.md:141:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 141,
        "line_end": 141,
        "snippet": "ls -la ~/.claude/agents/"
      },
      {
        "id": "filesystem:references/debug-commands.md:145:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 145,
        "line_end": 145,
        "snippet": "ls -la ~/.claude/commands/"
      },
      {
        "id": "filesystem:references/debug-commands.md:149:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 149,
        "line_end": 149,
        "snippet": "ls -la ~/.claude/rules/"
      },
      {
        "id": "filesystem:references/debug-commands.md:159:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 159,
        "line_end": 159,
        "snippet": "cat ~/.claude/settings.json | jq '.'"
      },
      {
        "id": "filesystem:references/debug-commands.md:228:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 228,
        "line_end": 228,
        "snippet": "ls -la ~/.claude/sessions/"
      },
      {
        "id": "filesystem:references/debug-commands.md:231:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/debug-commands.md",
        "line_start": 231,
        "line_end": 231,
        "snippet": "cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)"
      },
      {
        "id": "filesystem:references/debug-commands.md:82:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 82,
        "line_end": 82,
        "snippet": "1. ~/.claude/CLAUDE.md (user)"
      },
      {
        "id": "filesystem:references/debug-commands.md:84:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 84,
        "line_end": 84,
        "snippet": "3. ./.claude/CLAUDE.md (project)"
      },
      {
        "id": "filesystem:references/debug-commands.md:109:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 109,
        "line_end": 109,
        "snippet": "- filesystem: /Users/me/.npm/_npx/..."
      },
      {
        "id": "filesystem:references/debug-commands.md:110:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 110,
        "line_end": 110,
        "snippet": "- github: /Users/me/.npm/_npx/..."
      },
      {
        "id": "filesystem:references/debug-commands.md:137:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 137,
        "line_end": 137,
        "snippet": "ls -la ~/.claude/skills/"
      },
      {
        "id": "filesystem:references/debug-commands.md:141:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 141,
        "line_end": 141,
        "snippet": "ls -la ~/.claude/agents/"
      },
      {
        "id": "filesystem:references/debug-commands.md:145:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 145,
        "line_end": 145,
        "snippet": "ls -la ~/.claude/commands/"
      },
      {
        "id": "filesystem:references/debug-commands.md:149:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 149,
        "line_end": 149,
        "snippet": "ls -la ~/.claude/rules/"
      },
      {
        "id": "filesystem:references/debug-commands.md:159:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 159,
        "line_end": 159,
        "snippet": "cat ~/.claude/settings.json | jq '.'"
      },
      {
        "id": "filesystem:references/debug-commands.md:228:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 228,
        "line_end": 228,
        "snippet": "ls -la ~/.claude/sessions/"
      },
      {
        "id": "filesystem:references/debug-commands.md:231:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/debug-commands.md",
        "line_start": 231,
        "line_end": 231,
        "snippet": "cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)"
      },
      {
        "id": "env_access:references/debug-commands.md:241:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/debug-commands.md",
        "line_start": 241,
        "line_end": 241,
        "snippet": "echo ${ANTHROPIC_API_KEY:0:10}..."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:91:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/troubleshooting-flow.md",
        "line_start": 91,
        "line_end": 91,
        "snippet": "│  ├─ ~/.claude/agents/name.md (user)"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:121:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/troubleshooting-flow.md",
        "line_start": 121,
        "line_end": 121,
        "snippet": "│  ├─ ~/.claude/commands/name.md (user)"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:173:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/troubleshooting-flow.md",
        "line_start": 173,
        "line_end": 173,
        "snippet": "│  │  jq '.permissions.deny' ~/.claude/settings.json"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:179:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/troubleshooting-flow.md",
        "line_start": 179,
        "line_end": 179,
        "snippet": "│      │  │  jq '.permissions.allow' ~/.claude/settings.json"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:91:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/troubleshooting-flow.md",
        "line_start": 91,
        "line_end": 91,
        "snippet": "│  ├─ ~/.claude/agents/name.md (user)"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:121:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/troubleshooting-flow.md",
        "line_start": 121,
        "line_end": 121,
        "snippet": "│  ├─ ~/.claude/commands/name.md (user)"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:173:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/troubleshooting-flow.md",
        "line_start": 173,
        "line_end": 173,
        "snippet": "│  │  jq '.permissions.deny' ~/.claude/settings.json"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:179:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/troubleshooting-flow.md",
        "line_start": 179,
        "line_end": 179,
        "snippet": "│      │  │  jq '.permissions.allow' ~/.claude/settings.json"
      },
      {
        "id": "sensitive:references/troubleshooting-flow.md:154:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/troubleshooting-flow.md",
        "line_start": 154,
        "line_end": 154,
        "snippet": "│      │      │  ├─ Missing ──► Set env vars or add to .env"
      },
      {
        "id": "blocker:references/troubleshooting-flow.md:61:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/troubleshooting-flow.md",
        "line_start": 61,
        "line_end": 61,
        "snippet": "│      ├─ Is settings.json valid JSON?"
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 25,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 25,
        "line_end": 32,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 32,
        "line_end": 32,
        "snippet": "| Hook not running | Check `chmod +x`, run `/hooks` |"
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 39,
        "snippet": "| MCP connection fails | Test server manually with `npx` |"
      },
      {
        "id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 39,
        "line_end": 47,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 47,
        "line_end": 53,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 53,
        "line_end": 64,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 64,
        "line_end": 68,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 78,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 78,
        "line_end": 82,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 82,
        "line_end": 92,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 92,
        "line_end": 96,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 96,
        "line_end": 105,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 105,
        "line_end": 116,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 116,
        "line_end": 117,
        "snippet": "- `./references/common-issues.md` - Issue → Solution lookup table"
      },
      {
        "id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 117,
        "line_end": 118,
        "snippet": "- `./references/debug-commands.md` - All inspection commands"
      },
      {
        "id": "external_commands:SKILL.md:118:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 118,
        "line_end": 122,
        "snippet": "- `./references/troubleshooting-flow.md` - Decision tree"
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 122,
        "line_end": 122,
        "snippet": "**See Also:** `claude-code-hooks` for hook debugging, `claude-code-templates` for correct structure"
      },
      {
        "id": "network:SKILL.md:109:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 109,
        "line_end": 109,
        "snippet": "- https://code.claude.com/docs/en/hooks - Hooks reference"
      },
      {
        "id": "network:SKILL.md:110:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 110,
        "line_end": 110,
        "snippet": "- https://code.claude.com/docs/en/skills - Skills reference"
      },
      {
        "id": "network:SKILL.md:111:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 111,
        "line_end": 111,
        "snippet": "- https://code.claude.com/docs/en/sub-agents - Custom subagents"
      },
      {
        "id": "network:SKILL.md:112:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 112,
        "line_end": 112,
        "snippet": "- https://code.claude.com/docs/en/settings - Settings configuration"
      },
      {
        "id": "filesystem:SKILL.md:77:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "SKILL.md",
        "line_start": 77,
        "line_end": 77,
        "snippet": "jq '.' ~/.claude/settings.json"
      },
      {
        "id": "filesystem:SKILL.md:84:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "SKILL.md",
        "line_start": 84,
        "line_end": 84,
        "snippet": "ls ~/.claude/agents/"
      },
      {
        "id": "filesystem:SKILL.md:77:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 77,
        "line_end": 77,
        "snippet": "jq '.' ~/.claude/settings.json"
      },
      {
        "id": "filesystem:SKILL.md:84:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 84,
        "line_end": 84,
        "snippet": "ls ~/.claude/agents/"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:references/common-issues.md:26:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "This is a local shell assignment that derives the current directory name from pwd for a name check. It does not fetch remote data, execute untrusted input, or persist changes."
      },
      {
        "id": "filesystem:references/common-issues.md:13:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:60:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/common-issues.md:89:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:99:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:191:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/common-issues.md:203:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:13:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:60:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/common-issues.md:89:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:99:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:154:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The line references Claude memory file locations for troubleshooting. It is a location or existence check, not an instruction to exfiltrate hidden file contents."
      },
      {
        "id": "filesystem:references/common-issues.md:191:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/common-issues.md:203:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/common-issues.md:164:standard-device-file-access",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is shell error redirection to /dev/null in a diagnostic command. It does not access sensitive device data or hide malicious activity."
      },
      {
        "id": "filesystem:references/common-issues.md:194:standard-device-file-access",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is shell error redirection to /dev/null in a diagnostic command. It does not access sensitive device data or hide malicious activity."
      },
      {
        "id": "env_access:references/common-issues.md:137:git-platform-tokens",
        "verdict": "confirmed",
        "confidence": 0.94,
        "reason": "The documentation tells the user to print GITHUB_TOKEN directly. That can expose a GitHub credential in terminal output, logs, or copied diagnostics.",
        "severity": "high"
      },
      {
        "id": "blocker:references/common-issues.md:45:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line describes ordinary validation or troubleshooting checks. It does not collect system inventory beyond the local configuration context needed for debugging."
      },
      {
        "id": "blocker:references/common-issues.md:90:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line describes ordinary validation or troubleshooting checks. It does not collect system inventory beyond the local configuration context needed for debugging."
      },
      {
        "id": "external_commands:references/debug-commands.md:231:shell-command-substitution",
        "verdict": "confirmed",
        "confidence": 0.78,
        "reason": "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.",
        "severity": "high"
      },
      {
        "id": "filesystem:references/debug-commands.md:82:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The line references Claude memory file locations for troubleshooting. It is a location or existence check, not an instruction to exfiltrate hidden file contents."
      },
      {
        "id": "filesystem:references/debug-commands.md:137:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:141:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:145:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:149:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:159:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/debug-commands.md:228:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.72,
        "reason": "The line lists the Claude sessions directory but does not read file contents. The nearby session-reading command is handled separately as confirmed risk."
      },
      {
        "id": "filesystem:references/debug-commands.md:231:hidden-file-in-home-directory",
        "verdict": "confirmed",
        "confidence": 0.9,
        "reason": "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.",
        "severity": "high"
      },
      {
        "id": "filesystem:references/debug-commands.md:82:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The line references Claude memory file locations for troubleshooting. It is a location or existence check, not an instruction to exfiltrate hidden file contents."
      },
      {
        "id": "filesystem:references/debug-commands.md:84:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The line references Claude memory file locations for troubleshooting. It is a location or existence check, not an instruction to exfiltrate hidden file contents."
      },
      {
        "id": "filesystem:references/debug-commands.md:109:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:110:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:137:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:141:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:145:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:149:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/debug-commands.md:159:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/debug-commands.md:228:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.72,
        "reason": "The line lists the Claude sessions directory but does not read file contents. The nearby session-reading command is handled separately as confirmed risk."
      },
      {
        "id": "filesystem:references/debug-commands.md:231:hidden-file-access",
        "verdict": "confirmed",
        "confidence": 0.9,
        "reason": "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.",
        "severity": "high"
      },
      {
        "id": "env_access:references/debug-commands.md:241:generic-api-secret-keys",
        "verdict": "confirmed",
        "confidence": 0.9,
        "reason": "The command displays the first characters of ANTHROPIC_API_KEY. Even partial API key disclosure is unnecessary for troubleshooting and can leak credential material.",
        "severity": "high"
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:91:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:121:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:173:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:179:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:91:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:121:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:173:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:references/troubleshooting-flow.md:179:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "sensitive:references/troubleshooting-flow.md:154:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The line advises setting a missing environment variable or adding it to a .env file. It does not read, print, or exfiltrate an environment file."
      },
      {
        "id": "blocker:references/troubleshooting-flow.md:61:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line describes ordinary validation or troubleshooting checks. It does not collect system inventory beyond the local configuration context needed for debugging."
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:118:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is triggered by Markdown command formatting or inline backticks in documentation. The skill does not contain executable code that runs these commands automatically."
      },
      {
        "id": "network:SKILL.md:109:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL is an official Claude Code documentation link. It is a user-facing reference, not a background network request or data transfer."
      },
      {
        "id": "network:SKILL.md:110:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL is an official Claude Code documentation link. It is a user-facing reference, not a background network request or data transfer."
      },
      {
        "id": "network:SKILL.md:111:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL is an official Claude Code documentation link. It is a user-facing reference, not a background network request or data transfer."
      },
      {
        "id": "network:SKILL.md:112:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL is an official Claude Code documentation link. It is a user-facing reference, not a background network request or data transfer."
      },
      {
        "id": "filesystem:SKILL.md:77:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:SKILL.md:84:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      },
      {
        "id": "filesystem:SKILL.md:77:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "The line inspects local Claude settings for permission troubleshooting. It is contextual debugging guidance with no network transmission or automated modification."
      },
      {
        "id": "filesystem:SKILL.md:84:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line documents expected Claude Code extension paths or local directory listings. It is scoped troubleshooting guidance and does not transmit or modify user files."
      }
    ],
    "semantic_findings": [
      {
        "title": "Sensitive Token Display Guidance",
        "description": "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.",
        "severity": "high",
        "locations": [
          {
            "file": "references/common-issues.md",
            "line_start": 137,
            "line_end": 137
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 240,
            "line_end": 241
          }
        ],
        "confidence": 0.93,
        "confidence_reasoning": "The cited commands explicitly display token material, so the risk is semantic and intentional, not only a variable-name match."
      },
      {
        "title": "Sensitive Session Log Disclosure Guidance",
        "description": "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.",
        "severity": "high",
        "locations": [
          {
            "file": "references/debug-commands.md",
            "line_start": 227,
            "line_end": 231
          }
        ],
        "confidence": 0.9,
        "confidence_reasoning": "The command directly reads the latest file from the Claude sessions directory and prints it, which confirms session content disclosure risk."
      }
    ],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Git platform tokens",
        "description": "echo $GITHUB_TOKEN",
        "locations": [
          {
            "file": "references/common-issues.md",
            "line_start": 137,
            "line_end": 137
          }
        ],
        "review_kind": "capability",
        "source_category": "env_access",
        "source_severity": "high",
        "confidence": 0.94,
        "confidence_reasoning": "The documentation tells the user to print GITHUB_TOKEN directly. That can expose a GitHub credential in terminal output, logs, or copied diagnostics."
      },
      {
        "title": "Shell command substitution",
        "description": "cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)",
        "locations": [
          {
            "file": "references/debug-commands.md",
            "line_start": 231,
            "line_end": 231
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.78,
        "confidence_reasoning": "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."
      },
      {
        "title": "Hidden file in home directory",
        "description": "cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)",
        "locations": [
          {
            "file": "references/debug-commands.md",
            "line_start": 231,
            "line_end": 231
          }
        ],
        "review_kind": "capability",
        "source_category": "filesystem",
        "source_severity": "high",
        "confidence": 0.9,
        "confidence_reasoning": "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."
      },
      {
        "title": "Hidden file access",
        "description": "cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)",
        "locations": [
          {
            "file": "references/debug-commands.md",
            "line_start": 231,
            "line_end": 231
          }
        ],
        "review_kind": "capability",
        "source_category": "filesystem",
        "source_severity": "medium",
        "confidence": 0.9,
        "confidence_reasoning": "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."
      },
      {
        "title": "Generic API/secret keys",
        "description": "echo ${ANTHROPIC_API_KEY:0:10}...",
        "locations": [
          {
            "file": "references/debug-commands.md",
            "line_start": 241,
            "line_end": 241
          }
        ],
        "review_kind": "capability",
        "source_category": "env_access",
        "source_severity": "high",
        "confidence": 0.9,
        "confidence_reasoning": "The command displays the first characters of ANTHROPIC_API_KEY. Even partial API key disclosure is unnecessary for troubleshooting and can leak credential material."
      },
      {
        "title": "Sensitive Token Display Guidance",
        "description": "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.",
        "locations": [
          {
            "file": "references/common-issues.md",
            "line_start": 137,
            "line_end": 137
          },
          {
            "file": "references/debug-commands.md",
            "line_start": 240,
            "line_end": 241
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "high",
        "confidence": 0.93,
        "confidence_reasoning": "The cited commands explicitly display token material, so the risk is semantic and intentional, not only a variable-name match."
      },
      {
        "title": "Sensitive Session Log Disclosure Guidance",
        "description": "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.",
        "locations": [
          {
            "file": "references/debug-commands.md",
            "line_start": 227,
            "line_end": 231
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "high",
        "confidence": 0.9,
        "confidence_reasoning": "The command directly reads the latest file from the Claude sessions directory and prints it, which confirms session content disclosure risk."
      }
    ],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 4,
    "total_lines": 823,
    "audit_model": "codex",
    "audited_at": "2026-07-04T16:44:05.652Z",
    "agent_auto_install_policy": "confirmation_required",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Debug Claude Code Extension Issues",
    "value_statement": "Claude Code extensions can fail because of file layout, frontmatter, permissions, hooks, agents, or MCP configuration. This skill gives practical diagnostic flows and command references for isolating the cause.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Claude Code debugging",
      "Claude hooks",
      "Claude agents",
      "MCP troubleshooting",
      "skill loading",
      "settings.json",
      "developer tools"
    ],
    "actual_capabilities": [
      "Diagnoses skill activation problems by checking file location, naming, frontmatter, and trigger descriptions.",
      "Troubleshoots hook execution with matcher checks, executable permissions, JSON validation, and manual test guidance.",
      "Inspects agent discovery and tool availability using Claude Code slash command workflows.",
      "Reviews MCP connection problems, package availability, transport choices, and environment variable references.",
      "Provides decision trees and command references for repeatable Claude Code extension debugging."
    ],
    "limitations": [
      "Some diagnostics require access to local project files or Claude configuration paths.",
      "It does not automatically repair scripts, settings, or extension files without a separate user-approved edit.",
      "Diagnostic output can contain sensitive local paths, settings, session data, or secrets unless redacted.",
      "It focuses on Claude Code extension behavior, not general application debugging."
    ],
    "use_cases": [
      {
        "title": "Fix Skill Activation",
        "description": "Find why a Claude Code skill does not load or activate by checking structure, metadata, and trigger wording.",
        "target_user": "Skill author"
      },
      {
        "title": "Trace Hook Failures",
        "description": "Identify why a PreToolUse or PostToolUse hook is missing, not executable, mismatched, or returning the wrong exit code.",
        "target_user": "Automation developer"
      },
      {
        "title": "Validate Agent and MCP Setup",
        "description": "Check custom agent visibility and MCP server registration when Claude Code tools are unavailable or unstable.",
        "target_user": "Team maintainer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Check a Skill That Will Not Load",
        "scenario": "Beginner diagnosis for one skill.",
        "prompt": "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."
      },
      {
        "title": "Find Why a Hook Is Not Running",
        "scenario": "Intermediate hook troubleshooting.",
        "prompt": "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."
      },
      {
        "title": "Diagnose Agent or MCP Discovery",
        "scenario": "Advanced setup investigation.",
        "prompt": "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."
      },
      {
        "title": "Audit a Full Extension Setup",
        "scenario": "Advanced multi-component debugging plan.",
        "prompt": "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."
      }
    ],
    "output_examples": [
      {
        "input": "My hook appears in settings but never blocks a tool call.",
        "output": [
          "Confirm the hook is registered for the exact tool name and event type.",
          "Check that the script is executable and can read sample input from standard input.",
          "Verify that blocking behavior uses the expected exit code and writes the message to the correct stream."
        ]
      },
      {
        "input": "My custom agent file exists, but Claude Code never selects it.",
        "output": [
          "Verify that the agent file is in a supported user or project agent directory.",
          "Check the frontmatter name and description for clear usage signals.",
          "Use the agent list view to confirm discovery before testing delegation."
        ]
      },
      {
        "input": "An MCP server is configured, but its tools do not appear.",
        "output": [
          "Test whether the server package can start outside Claude Code.",
          "Review transport settings and referenced environment variables.",
          "Confirm that permission rules allow the expected MCP tool names."
        ]
      }
    ],
    "best_practices": [
      "Redact tokens, secrets, local paths, and session content before sharing diagnostic output.",
      "Run checks from the intended project root and confirm scope before inspecting user-level configuration.",
      "Start with Claude Code debug output, then verify structure, permissions, and metadata in order."
    ],
    "anti_patterns": [
      "Printing full API tokens or pasting raw session logs into a chat, issue, or support request.",
      "Broadening tool permissions before checking deny rules, hook matchers, and exact command patterns.",
      "Assuming an extension loaded before verifying filename, directory location, and frontmatter syntax."
    ],
    "faq": [
      {
        "question": "What problems does this skill help debug?",
        "answer": "It helps debug Claude Code skills, hooks, agents, MCP servers, settings, permissions, and related extension loading behavior."
      },
      {
        "question": "Does it change my Claude Code configuration?",
        "answer": "The skill provides diagnostic steps. Any configuration change should be reviewed and approved separately."
      },
      {
        "question": "Can it inspect global Claude settings?",
        "answer": "Some examples inspect user-level Claude settings. Review and redact output before sharing it outside your machine."
      },
      {
        "question": "Is it safe to print API keys while debugging?",
        "answer": "No. Use presence checks or redacted values instead of printing full or partial API keys."
      },
      {
        "question": "Can it help with MCP server failures?",
        "answer": "Yes. It covers package checks, configuration entries, transport settings, environment references, and tool permissions."
      },
      {
        "question": "Does it replace official Claude Code documentation?",
        "answer": "No. It organizes troubleshooting steps and links to official documentation for deeper reference."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "common-issues.md",
          "type": "file",
          "path": "references/common-issues.md",
          "lines": 209
        },
        {
          "name": "debug-commands.md",
          "type": "file",
          "path": "references/debug-commands.md",
          "lines": 277
        },
        {
          "name": "troubleshooting-flow.md",
          "type": "file",
          "path": "references/troubleshooting-flow.md",
          "lines": 214
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 123
    }
  ]
}
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall