Skip to content

aiskillstore/marketplace / skills/0xraduan/skill-builder

skill-builder

Verified

Interactive skill creation assistant that guides users through building new Agent Skills for Claude Code. Use when creating new skills, building custom capabilities, or when the user runs /new-skill command. Helps design skill structure, craft descriptions, create scripts, and organize supporting files.

FileKindSize
REFERENCE.mdmarkdown21.4 KB
SKILL.mdskill md11.4 KB
skill-report.jsonconfig63.4 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T16:50:12.433Z",
    "slug": "0xraduan-skill-builder",
    "source_url": "https://github.com/0xRaduan/personal-os/tree/master/skills/skill-builder",
    "source_ref": "master",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "6e53a5de6a952df607e2ce0def607b51d644ccb569a29750e65d556362fe6d3c",
    "tree_hash": "702e6ac0d7e54fb4317f6dbfefe82ecd16d7b43b17215bb52895d3d9badb1159",
    "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": "skill-builder",
    "description": "Interactive skill creation assistant that guides users through building Agent Skills for Claude Code. Use it to design skill structure, write clear descriptions, create templates, and organize supporting files.",
    "summary": "Guide users through creating structured Agent Skills for Claude Code.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "0xRaduan",
    "license": "MIT",
    "tags": [
      "skill-creation",
      "claude-code",
      "agent-skills",
      "developer-tools",
      "documentation"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "scripts",
      "external_commands",
      "filesystem",
      "env_access",
      "network"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All static findings were false positives from Markdown examples, templates, and documentation references. The skill contains no executable helper files, and no prompt-injection attempts were found in SKILL.md or REFERENCE.md. Generated scripts and install paths should still be reviewed before use because the skill can guide users to create files and commands.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "scripts",
        "evidence": [
          {
            "file": "REFERENCE.md",
            "line_start": 553,
            "line_end": 553
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "REFERENCE.md",
            "line_start": 264,
            "line_end": 269
          },
          {
            "file": "REFERENCE.md",
            "line_start": 269,
            "line_end": 275
          },
          {
            "file": "REFERENCE.md",
            "line_start": 565,
            "line_end": 565
          },
          {
            "file": "REFERENCE.md",
            "line_start": 631,
            "line_end": 636
          },
          {
            "file": "REFERENCE.md",
            "line_start": 683,
            "line_end": 684
          },
          {
            "file": "REFERENCE.md",
            "line_start": 684,
            "line_end": 688
          },
          {
            "file": "REFERENCE.md",
            "line_start": 688,
            "line_end": 708
          },
          {
            "file": "REFERENCE.md",
            "line_start": 511,
            "line_end": 511
          },
          {
            "file": "REFERENCE.md",
            "line_start": 455,
            "line_end": 455
          },
          {
            "file": "SKILL.md",
            "line_start": 21,
            "line_end": 21
          },
          {
            "file": "SKILL.md",
            "line_start": 43,
            "line_end": 57
          },
          {
            "file": "SKILL.md",
            "line_start": 57,
            "line_end": 74
          },
          {
            "file": "SKILL.md",
            "line_start": 74,
            "line_end": 76
          },
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 86
          },
          {
            "file": "SKILL.md",
            "line_start": 86,
            "line_end": 89
          },
          {
            "file": "SKILL.md",
            "line_start": 89,
            "line_end": 95
          },
          {
            "file": "SKILL.md",
            "line_start": 95,
            "line_end": 101
          },
          {
            "file": "SKILL.md",
            "line_start": 101,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 116
          },
          {
            "file": "SKILL.md",
            "line_start": 116,
            "line_end": 119
          },
          {
            "file": "SKILL.md",
            "line_start": 119,
            "line_end": 122
          },
          {
            "file": "SKILL.md",
            "line_start": 122,
            "line_end": 127
          },
          {
            "file": "SKILL.md",
            "line_start": 127,
            "line_end": 130
          },
          {
            "file": "SKILL.md",
            "line_start": 130,
            "line_end": 136
          },
          {
            "file": "SKILL.md",
            "line_start": 136,
            "line_end": 141
          },
          {
            "file": "SKILL.md",
            "line_start": 141,
            "line_end": 149
          },
          {
            "file": "SKILL.md",
            "line_start": 149,
            "line_end": 150
          },
          {
            "file": "SKILL.md",
            "line_start": 150,
            "line_end": 153
          },
          {
            "file": "SKILL.md",
            "line_start": 153,
            "line_end": 155
          },
          {
            "file": "SKILL.md",
            "line_start": 155,
            "line_end": 161
          },
          {
            "file": "SKILL.md",
            "line_start": 161,
            "line_end": 162
          },
          {
            "file": "SKILL.md",
            "line_start": 162,
            "line_end": 164
          },
          {
            "file": "SKILL.md",
            "line_start": 164,
            "line_end": 168
          },
          {
            "file": "SKILL.md",
            "line_start": 168,
            "line_end": 181
          },
          {
            "file": "SKILL.md",
            "line_start": 181,
            "line_end": 183
          },
          {
            "file": "SKILL.md",
            "line_start": 183,
            "line_end": 202
          },
          {
            "file": "SKILL.md",
            "line_start": 202,
            "line_end": 206
          },
          {
            "file": "SKILL.md",
            "line_start": 206,
            "line_end": 208
          },
          {
            "file": "SKILL.md",
            "line_start": 208,
            "line_end": 210
          },
          {
            "file": "SKILL.md",
            "line_start": 210,
            "line_end": 254
          },
          {
            "file": "SKILL.md",
            "line_start": 254,
            "line_end": 257
          },
          {
            "file": "SKILL.md",
            "line_start": 257,
            "line_end": 261
          },
          {
            "file": "SKILL.md",
            "line_start": 261,
            "line_end": 261
          },
          {
            "file": "SKILL.md",
            "line_start": 274,
            "line_end": 290
          },
          {
            "file": "SKILL.md",
            "line_start": 290,
            "line_end": 323
          },
          {
            "file": "SKILL.md",
            "line_start": 323,
            "line_end": 327
          },
          {
            "file": "SKILL.md",
            "line_start": 327,
            "line_end": 348
          },
          {
            "file": "SKILL.md",
            "line_start": 348,
            "line_end": 348
          },
          {
            "file": "SKILL.md",
            "line_start": 358,
            "line_end": 375
          },
          {
            "file": "SKILL.md",
            "line_start": 375,
            "line_end": 380
          },
          {
            "file": "SKILL.md",
            "line_start": 380,
            "line_end": 393
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "REFERENCE.md",
            "line_start": 863,
            "line_end": 863
          },
          {
            "file": "REFERENCE.md",
            "line_start": 872,
            "line_end": 872
          },
          {
            "file": "REFERENCE.md",
            "line_start": 947,
            "line_end": 947
          },
          {
            "file": "REFERENCE.md",
            "line_start": 863,
            "line_end": 863
          },
          {
            "file": "REFERENCE.md",
            "line_start": 872,
            "line_end": 872
          },
          {
            "file": "REFERENCE.md",
            "line_start": 947,
            "line_end": 947
          },
          {
            "file": "SKILL.md",
            "line_start": 55,
            "line_end": 55
          },
          {
            "file": "SKILL.md",
            "line_start": 161,
            "line_end": 161
          },
          {
            "file": "SKILL.md",
            "line_start": 55,
            "line_end": 55
          },
          {
            "file": "SKILL.md",
            "line_start": 161,
            "line_end": 161
          },
          {
            "file": "SKILL.md",
            "line_start": 162,
            "line_end": 162
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "REFERENCE.md",
            "line_start": 565,
            "line_end": 565
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 30,
            "line_end": 30
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "scripts:REFERENCE.md:553:dynamic-code-evaluation-with-eval",
        "category": "scripts",
        "severity": "high",
        "pattern": "Dynamic code evaluation with eval()",
        "file": "REFERENCE.md",
        "line_start": 553,
        "line_end": 553,
        "snippet": "- Unsafe eval() usage"
      },
      {
        "id": "external_commands:REFERENCE.md:264:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "REFERENCE.md",
        "line_start": 264,
        "line_end": 269,
        "snippet": "Scripts use `uv` for dependency management. Dependencies are declared inline using PEP 723 metadata."
      },
      {
        "id": "external_commands:REFERENCE.md:269:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "REFERENCE.md",
        "line_start": 269,
        "line_end": 275,
        "snippet": "2. Run with: `uv run scripts/processor.py <args>`"
      },
      {
        "id": "external_commands:REFERENCE.md:565:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "REFERENCE.md",
        "line_start": 565,
        "line_end": 565,
        "snippet": "Use Grep to search for patterns like `api_key=`, `password=`, `SECRET_KEY`"
      },
      {
        "id": "external_commands:REFERENCE.md:631:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "REFERENCE.md",
        "line_start": 631,
        "line_end": 636,
        "snippet": "The script uses `uv` for dependency management. Dependencies are declared inline using PEP 723 metad"
      },
      {
        "id": "external_commands:REFERENCE.md:683:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "REFERENCE.md",
        "line_start": 683,
        "line_end": 684,
        "snippet": "- [ ] Run linter: `npm run lint`"
      },
      {
        "id": "external_commands:REFERENCE.md:684:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "REFERENCE.md",
        "line_start": 684,
        "line_end": 688,
        "snippet": "- [ ] Run tests: `npm run test`"
      },
      {
        "id": "external_commands:REFERENCE.md:688:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "REFERENCE.md",
        "line_start": 688,
        "line_end": 708,
        "snippet": "- [ ] Production build succeeds: `npm run build`"
      },
      {
        "id": "external_commands:REFERENCE.md:511:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "REFERENCE.md",
        "line_start": 511,
        "line_end": 511,
        "snippet": "result=$(cat \"$INPUT\")  # Replace with actual processing"
      },
      {
        "id": "external_commands:REFERENCE.md:455:unix-shell-invocation",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Unix shell invocation",
        "file": "REFERENCE.md",
        "line_start": 455,
        "line_end": 455,
        "snippet": "#!/bin/bash"
      },
      {
        "id": "filesystem:REFERENCE.md:863:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "REFERENCE.md",
        "line_start": 863,
        "line_end": 863,
        "snippet": "ls -la ~/.claude/skills/skill-name/"
      },
      {
        "id": "filesystem:REFERENCE.md:872:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "REFERENCE.md",
        "line_start": 872,
        "line_end": 872,
        "snippet": "head -n 10 ~/.claude/skills/skill-name/SKILL.md"
      },
      {
        "id": "filesystem:REFERENCE.md:947:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "REFERENCE.md",
        "line_start": 947,
        "line_end": 947,
        "snippet": "Personal skills: ~/.claude/skills/"
      },
      {
        "id": "filesystem:REFERENCE.md:863:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "REFERENCE.md",
        "line_start": 863,
        "line_end": 863,
        "snippet": "ls -la ~/.claude/skills/skill-name/"
      },
      {
        "id": "filesystem:REFERENCE.md:872:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "REFERENCE.md",
        "line_start": 872,
        "line_end": 872,
        "snippet": "head -n 10 ~/.claude/skills/skill-name/SKILL.md"
      },
      {
        "id": "filesystem:REFERENCE.md:947:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "REFERENCE.md",
        "line_start": 947,
        "line_end": 947,
        "snippet": "Personal skills: ~/.claude/skills/"
      },
      {
        "id": "env_access:REFERENCE.md:565:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "REFERENCE.md",
        "line_start": 565,
        "line_end": 565,
        "snippet": "Use Grep to search for patterns like `api_key=`, `password=`, `SECRET_KEY`"
      },
      {
        "id": "sensitive:REFERENCE.md:552:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "REFERENCE.md",
        "line_start": 552,
        "line_end": 552,
        "snippet": "- Exposed credentials in .env files"
      },
      {
        "id": "blocker:REFERENCE.md:911:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "REFERENCE.md",
        "line_start": 911,
        "line_end": 911,
        "snippet": "- [ ] YAML frontmatter is valid (opening and closing `---`)"
      },
      {
        "id": "blocker:REFERENCE.md:664:network-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "Network reconnaissance",
        "file": "REFERENCE.md",
        "line_start": 664,
        "line_end": 665,
        "snippet": "- Multi-step process"
      },
      {
        "id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 21,
        "line_end": 21,
        "snippet": "- User runs `/new-skill` command"
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 43,
        "line_end": 57,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 57,
        "line_end": 74,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 74,
        "line_end": 76,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 76,
        "line_end": 79,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 79,
        "line_end": 81,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 81,
        "line_end": 84,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 84,
        "line_end": 86,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 86,
        "line_end": 89,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 89,
        "line_end": 95,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 95,
        "line_end": 101,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:101:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 101,
        "line_end": 111,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 111,
        "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": 119,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 119,
        "line_end": 122,
        "snippet": "```"
      },
      {
        "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": 127,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:127:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 127,
        "line_end": 130,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 130,
        "line_end": 136,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 136,
        "line_end": 141,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 141,
        "line_end": 149,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 149,
        "line_end": 150,
        "snippet": "This uses the `allowed-tools` frontmatter field."
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 150,
        "line_end": 153,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:153:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 153,
        "line_end": 155,
        "snippet": "```yaml"
      },
      {
        "id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 155,
        "line_end": 161,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 161,
        "line_end": 162,
        "snippet": "- Personal: `~/.claude/skills/[skill-name]/`"
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 162,
        "line_end": 164,
        "snippet": "- Project: `[repo-root]/.claude/skills/[skill-name]/`"
      },
      {
        "id": "external_commands:SKILL.md:164:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 164,
        "line_end": 168,
        "snippet": "For personal-os repo, project skills go in: `[repo-root]/skills/[skill-name]/`"
      },
      {
        "id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 168,
        "line_end": 181,
        "snippet": "```yaml"
      },
      {
        "id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 181,
        "line_end": 183,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 183,
        "line_end": 202,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 202,
        "line_end": 206,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:206:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 206,
        "line_end": 208,
        "snippet": "If the user wants Python scripts, create self-contained scripts that use `uv` for dependency managem"
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 208,
        "line_end": 210,
        "snippet": "**IMPORTANT: Python scripts must be self-contained and runnable via `uv run`**"
      },
      {
        "id": "external_commands:SKILL.md:210:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 210,
        "line_end": 254,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:254:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 254,
        "line_end": 257,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:257:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 257,
        "line_end": 261,
        "snippet": "- Use `#!/usr/bin/env -S uv run` shebang"
      },
      {
        "id": "external_commands:SKILL.md:261:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 261,
        "line_end": 261,
        "snippet": "- Users run with: `uv run scripts/name.py` or just `./scripts/name.py` (if executable)"
      },
      {
        "id": "external_commands:SKILL.md:274:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 274,
        "line_end": 290,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:290:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 290,
        "line_end": 323,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:323:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 323,
        "line_end": 327,
        "snippet": "- Use `uv run` for all Python scripts with PEP 723 inline metadata"
      },
      {
        "id": "external_commands:SKILL.md:327:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 327,
        "line_end": 348,
        "snippet": "- Document usage in docstrings with `uv run` commands"
      },
      {
        "id": "external_commands:SKILL.md:348:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 348,
        "line_end": 348,
        "snippet": "- Add file extensions to description (`.pdf`, `.xlsx`, etc.)"
      },
      {
        "id": "external_commands:SKILL.md:358:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 358,
        "line_end": 375,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:375:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 375,
        "line_end": 380,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:380:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 380,
        "line_end": 393,
        "snippet": "```"
      },
      {
        "id": "network:SKILL.md:30:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 30,
        "line_end": 30,
        "snippet": "- **Primary reference**: https://docs.claude.com/en/docs/claude-code/skills.md"
      },
      {
        "id": "filesystem:SKILL.md:55:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "SKILL.md",
        "line_start": 55,
        "line_end": 55,
        "snippet": "- Personal skill (just for you: ~/.claude/skills/)"
      },
      {
        "id": "filesystem:SKILL.md:161:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "SKILL.md",
        "line_start": 161,
        "line_end": 161,
        "snippet": "- Personal: `~/.claude/skills/[skill-name]/`"
      },
      {
        "id": "filesystem:SKILL.md:55:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 55,
        "line_end": 55,
        "snippet": "- Personal skill (just for you: ~/.claude/skills/)"
      },
      {
        "id": "filesystem:SKILL.md:161:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 161,
        "line_end": 161,
        "snippet": "- Personal: `~/.claude/skills/[skill-name]/`"
      },
      {
        "id": "filesystem:SKILL.md:162:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 162,
        "line_end": 162,
        "snippet": "- Project: `[repo-root]/.claude/skills/[skill-name]/`"
      }
    ],
    "finding_verdicts": [
      {
        "id": "scripts:REFERENCE.md:553:dynamic-code-evaluation-with-eval",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 553 is a security checklist item that tells reviewers to look for unsafe eval() usage. It does not call eval() or introduce dynamic code execution."
      },
      {
        "id": "external_commands:REFERENCE.md:264:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text is a Markdown documentation example for commands such as uv or npm. The skill does not run those commands automatically or construct shell input."
      },
      {
        "id": "external_commands:REFERENCE.md:269:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text is a Markdown documentation example for commands such as uv or npm. The skill does not run those commands automatically or construct shell input."
      },
      {
        "id": "external_commands:REFERENCE.md:565:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The cited pattern appears only in documentation or templates for skill authors. No executable behavior or data access is present in the installed skill."
      },
      {
        "id": "external_commands:REFERENCE.md:631:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text is a Markdown documentation example for commands such as uv or npm. The skill does not run those commands automatically or construct shell input."
      },
      {
        "id": "external_commands:REFERENCE.md:683:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text is a Markdown documentation example for commands such as uv or npm. The skill does not run those commands automatically or construct shell input."
      },
      {
        "id": "external_commands:REFERENCE.md:684:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text is a Markdown documentation example for commands such as uv or npm. The skill does not run those commands automatically or construct shell input."
      },
      {
        "id": "external_commands:REFERENCE.md:688:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text is a Markdown documentation example for commands such as uv or npm. The skill does not run those commands automatically or construct shell input."
      },
      {
        "id": "external_commands:REFERENCE.md:511:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The shell substitution is inside an example Bash template and reads a quoted input file. The installed skill does not execute this snippet or pass untrusted data to a shell."
      },
      {
        "id": "external_commands:REFERENCE.md:455:unix-shell-invocation",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The shebang appears in a Bash script template for users who choose to create a helper script. There is no executable script shipped with the skill."
      },
      {
        "id": "filesystem:REFERENCE.md:863:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown as documentation for where personal Claude skills may be stored. No hidden file is read, written, or modified by this skill."
      },
      {
        "id": "filesystem:REFERENCE.md:872:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown as documentation for where personal Claude skills may be stored. No hidden file is read, written, or modified by this skill."
      },
      {
        "id": "filesystem:REFERENCE.md:947:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown as documentation for where personal Claude skills may be stored. No hidden file is read, written, or modified by this skill."
      },
      {
        "id": "filesystem:REFERENCE.md:863:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown as documentation for where personal Claude skills may be stored. No hidden file is read, written, or modified by this skill."
      },
      {
        "id": "filesystem:REFERENCE.md:872:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown as documentation for where personal Claude skills may be stored. No hidden file is read, written, or modified by this skill."
      },
      {
        "id": "filesystem:REFERENCE.md:947:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown as documentation for where personal Claude skills may be stored. No hidden file is read, written, or modified by this skill."
      },
      {
        "id": "env_access:REFERENCE.md:565:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This line lists search patterns for finding secrets during a security review. It does not contain real credentials or read environment variables."
      },
      {
        "id": "sensitive:REFERENCE.md:552:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This line warns reviewers to check for exposed credentials in .env files. It is defensive guidance, not environment file access by the skill."
      },
      {
        "id": "blocker:REFERENCE.md:911:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The cited line is a validation checklist item for YAML frontmatter. It does not inspect the host system or collect system information."
      },
      {
        "id": "blocker:REFERENCE.md:664:network-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The cited line describes a multi-step workflow pattern. It does not scan networks, enumerate hosts, or perform reconnaissance."
      },
      {
        "id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticked text is a Claude Code slash command trigger, not shell execution. It is documentation for when the skill activates."
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:101:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:127:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:153:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text documents target paths for personal or project skill files. Backticks mark inline paths, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text documents target paths for personal or project skill files. Backticks mark inline paths, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:164:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The cited text documents target paths for personal or project skill files. Backticks mark inline paths, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:206:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:210:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:254:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:257:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:261:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:274:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:290:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:323:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:327:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The cited text is part of a user-facing template for optional script-backed skills. The installed skill contains guidance only and does not execute the script template."
      },
      {
        "id": "external_commands:SKILL.md:348:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:358:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:375:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "external_commands:SKILL.md:380:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The finding is caused by Markdown code fences or inline formatting in skill-building instructions. There is no Ruby or shell execution at this location."
      },
      {
        "id": "network:SKILL.md:30:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The URL points to official Claude Code documentation for optional reference lookup. It is not an exfiltration endpoint or an automatic network request."
      },
      {
        "id": "filesystem:SKILL.md:55:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown to help users choose a personal or project skill location. It is not an automatic hidden-directory access by the skill."
      },
      {
        "id": "filesystem:SKILL.md:161:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown to help users choose a personal or project skill location. It is not an automatic hidden-directory access by the skill."
      },
      {
        "id": "filesystem:SKILL.md:55:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown to help users choose a personal or project skill location. It is not an automatic hidden-directory access by the skill."
      },
      {
        "id": "filesystem:SKILL.md:161:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown to help users choose a personal or project skill location. It is not an automatic hidden-directory access by the skill."
      },
      {
        "id": "filesystem:SKILL.md:162:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The path is shown to help users choose a personal or project skill location. It is not an automatic hidden-directory access by the skill."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 2,
    "total_lines": 1426,
    "audit_model": "codex",
    "audited_at": "2026-07-04T16:50:12.433Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Create Claude Code Skills",
    "value_statement": "Building a useful Agent Skill requires clear triggers, structure, and safe supporting files. This skill guides Claude or Codex through discovery, design, creation, and handoff.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Agent Skills",
      "skill builder",
      "SKILL.md",
      "Claude skills",
      "developer workflow",
      "skill templates",
      "AI automation"
    ],
    "actual_capabilities": [
      "Guides discovery questions for a new skill purpose, triggers, and scope.",
      "Helps write SKILL.md descriptions, frontmatter, instructions, and examples.",
      "Recommends simple, script-powered, or reference-backed skill layouts.",
      "Provides Python script templates using uv and PEP 723 metadata.",
      "Explains testing, activation checks, and iteration steps."
    ],
    "limitations": [
      "It does not automatically validate generated skills against marketplace policy.",
      "Users must review generated scripts before running them.",
      "Claude Code behavior can change, so current documentation may need verification.",
      "It provides guidance and templates, not a packaged skill compiler."
    ],
    "use_cases": [
      {
        "title": "Create a personal workflow skill",
        "description": "Design a focused skill for repeated tasks such as document review, test analysis, or report generation.",
        "target_user": "Individual developers"
      },
      {
        "title": "Standardize project skills",
        "description": "Create team-shared skills with clear triggers, file locations, examples, and maintenance notes.",
        "target_user": "Engineering teams"
      },
      {
        "title": "Plan script-backed automation",
        "description": "Decide when a skill needs helper scripts and document safe usage for those scripts.",
        "target_user": "Automation builders"
      }
    ],
    "prompt_templates": [
      {
        "title": "Create a basic skill",
        "scenario": "Beginner skill planning",
        "prompt": "Use skill-builder to help me create a simple Agent Skill for [task]. Ask clarifying questions before writing the skill."
      },
      {
        "title": "Design a project skill",
        "scenario": "Shared team workflow",
        "prompt": "Help me design a project-level Claude Code skill for [workflow]. Include triggers, scope, file structure, and test prompts."
      },
      {
        "title": "Add script support",
        "scenario": "Skill with helper tooling",
        "prompt": "Plan a script-backed skill for [automation]. Decide which scripts are needed and describe their inputs, outputs, and review steps."
      },
      {
        "title": "Refine an advanced skill",
        "scenario": "Improving an existing concept",
        "prompt": "Review my proposed skill for [domain]. Improve its trigger description, structure, safety notes, examples, and activation tests."
      }
    ],
    "output_examples": [
      {
        "input": "I need a skill for summarizing customer calls.",
        "output": [
          "A refined skill purpose and trigger description.",
          "A recommended instruction-only structure for the first version.",
          "Example prompts to test whether the skill activates correctly."
        ]
      },
      {
        "input": "Create a skill for analyzing Python test coverage.",
        "output": [
          "A focused description with pytest and coverage trigger terms.",
          "A recommended structure with optional helper script support.",
          "A handoff checklist for dependencies, examples, and testing."
        ]
      },
      {
        "input": "Improve this rough skill idea before I publish it.",
        "output": [
          "Clearer activation language and narrower scope.",
          "Suggested file organization using progressive disclosure.",
          "Review notes for scripts, dependencies, and user-facing examples."
        ]
      }
    ],
    "best_practices": [
      "Start with concrete trigger phrases that users would naturally write.",
      "Keep each skill focused on one capability and move details into reference files.",
      "Review generated scripts, dependencies, and file locations before use."
    ],
    "anti_patterns": [
      "Creating broad skills that try to handle unrelated workflows.",
      "Adding helper scripts when clear instructions would solve the task.",
      "Running generated commands or scripts before reviewing their purpose."
    ],
    "faq": [
      {
        "question": "What does this skill help create?",
        "answer": "It helps create Agent Skills with clear descriptions, instructions, examples, and optional supporting files."
      },
      {
        "question": "Can it create script-backed skills?",
        "answer": "Yes. It can plan Python or Bash helper scripts and document how users should run them."
      },
      {
        "question": "Does it publish skills automatically?",
        "answer": "No. It guides creation and handoff, but publishing and installation remain user-controlled steps."
      },
      {
        "question": "Does it work with Codex?",
        "answer": "The guidance is useful for Codex workflows, but the source skill is written for Claude Code Agent Skills."
      },
      {
        "question": "Should generated scripts be reviewed?",
        "answer": "Yes. Review scripts, dependencies, paths, and inputs before running or sharing them."
      },
      {
        "question": "When should I use a reference file?",
        "answer": "Use a reference file when the skill needs detailed examples, APIs, troubleshooting, or long workflow notes."
      }
    ]
  },
  "file_structure": [
    {
      "name": "REFERENCE.md",
      "type": "file",
      "path": "REFERENCE.md",
      "lines": 1015
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 411
    }
  ]
}
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall