Skip to content

aiskillstore/marketplace / skills/89jobrien/documentation

documentation

Verified

Comprehensive documentation specialist covering API documentation, technical writing, design documentation, migration guides, and changelog generation. Use when creating OpenAPI/Swagger specs, generating SDKs, writing user guides, creating README files, documenting architecture, writing design specs, creating ADRs, writing migration guides, or generating changelogs from git commits. Handles versioning, examples, developer experience, and user-facing documentation.

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-05T12:05:57.364Z",
    "slug": "89jobrien-documentation",
    "source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/documentation",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "ca6871ba517cb59a42ebd9042a5dd101d1bfebf31200e219af1b513324a033f9",
    "tree_hash": "bea5cd79f0b36ed8c640d4ba966019248e87523a64c58be5e6a0318fa79c0e3c",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "documentation",
    "description": "Create API, technical, architecture, migration, and changelog documentation with templates, examples, and publishing guidance.",
    "summary": "Documentation assistant for API references, guides, ADRs, migration plans, and changelogs.",
    "icon": "📦",
    "version": "1.0.2",
    "author": "Joseph OBrien",
    "license": "MIT",
    "tags": [
      "api-documentation",
      "technical-writing",
      "changelogs",
      "migration-guides",
      "architecture-docs"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network",
      "env_access"
    ],
    "category": "documentation"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "The static findings are documentation examples, placeholder credentials, Markdown code fences, and writing guidance. I found no evidence of executable malware behavior, live network exfiltration, real secret access, or prompt injection in the reviewed files.",
    "remediation": [
      {
        "issue": "Placeholder API keys trigger secret-detection patterns.",
        "suggestion": "Use clearly non-secret placeholders such as <replace-with-your-api-key> and state that examples are not live credentials.",
        "severity": "low"
      },
      {
        "issue": "Example commands and URLs trigger execution and network heuristics.",
        "suggestion": "Label command snippets as examples and keep placeholder domains or variables clearly non-production.",
        "severity": "low"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "references/api-docs.md",
            "line_start": 267,
            "line_end": 268
          },
          {
            "file": "references/changelogs.md",
            "line_start": 184,
            "line_end": 187
          },
          {
            "file": "references/changelogs.md",
            "line_start": 187,
            "line_end": 202
          },
          {
            "file": "references/technical-writing.md",
            "line_start": 175,
            "line_end": 175
          },
          {
            "file": "references/technical-writing.md",
            "line_start": 177,
            "line_end": 177
          },
          {
            "file": "references/technical-writing.md",
            "line_start": 181,
            "line_end": 181
          },
          {
            "file": "references/technical-writing.md",
            "line_start": 186,
            "line_end": 186
          },
          {
            "file": "SKILL.md",
            "line_start": 72,
            "line_end": 74
          },
          {
            "file": "SKILL.md",
            "line_start": 74,
            "line_end": 76
          },
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 78
          },
          {
            "file": "SKILL.md",
            "line_start": 78,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 86
          },
          {
            "file": "SKILL.md",
            "line_start": 86,
            "line_end": 88
          },
          {
            "file": "SKILL.md",
            "line_start": 88,
            "line_end": 92
          },
          {
            "file": "SKILL.md",
            "line_start": 92,
            "line_end": 94
          },
          {
            "file": "SKILL.md",
            "line_start": 94,
            "line_end": 96
          },
          {
            "file": "SKILL.md",
            "line_start": 96,
            "line_end": 98
          },
          {
            "file": "SKILL.md",
            "line_start": 98,
            "line_end": 123
          },
          {
            "file": "SKILL.md",
            "line_start": 123,
            "line_end": 143
          },
          {
            "file": "SKILL.md",
            "line_start": 143,
            "line_end": 241
          },
          {
            "file": "SKILL.md",
            "line_start": 241,
            "line_end": 243
          },
          {
            "file": "SKILL.md",
            "line_start": 243,
            "line_end": 245
          },
          {
            "file": "SKILL.md",
            "line_start": 245,
            "line_end": 247
          },
          {
            "file": "SKILL.md",
            "line_start": 247,
            "line_end": 249
          },
          {
            "file": "SKILL.md",
            "line_start": 249,
            "line_end": 251
          },
          {
            "file": "SKILL.md",
            "line_start": 251,
            "line_end": 255
          },
          {
            "file": "SKILL.md",
            "line_start": 255,
            "line_end": 257
          },
          {
            "file": "SKILL.md",
            "line_start": 257,
            "line_end": 261
          },
          {
            "file": "SKILL.md",
            "line_start": 261,
            "line_end": 264
          },
          {
            "file": "SKILL.md",
            "line_start": 264,
            "line_end": 268
          },
          {
            "file": "SKILL.md",
            "line_start": 268,
            "line_end": 289
          },
          {
            "file": "SKILL.md",
            "line_start": 289,
            "line_end": 295
          },
          {
            "file": "SKILL.md",
            "line_start": 295,
            "line_end": 296
          },
          {
            "file": "SKILL.md",
            "line_start": 296,
            "line_end": 297
          },
          {
            "file": "SKILL.md",
            "line_start": 297,
            "line_end": 298
          },
          {
            "file": "SKILL.md",
            "line_start": 298,
            "line_end": 299
          },
          {
            "file": "SKILL.md",
            "line_start": 299,
            "line_end": 300
          },
          {
            "file": "SKILL.md",
            "line_start": 300,
            "line_end": 301
          },
          {
            "file": "SKILL.md",
            "line_start": 301,
            "line_end": 302
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "references/api-docs.md",
            "line_start": 199,
            "line_end": 199
          },
          {
            "file": "references/api-docs.md",
            "line_start": 250,
            "line_end": 250
          },
          {
            "file": "references/api-docs.md",
            "line_start": 252,
            "line_end": 252
          },
          {
            "file": "references/api-docs.md",
            "line_start": 281,
            "line_end": 281
          },
          {
            "file": "references/api-docs.md",
            "line_start": 288,
            "line_end": 288
          },
          {
            "file": "references/api-docs.md",
            "line_start": 46,
            "line_end": 46
          },
          {
            "file": "references/api-docs.md",
            "line_start": 49,
            "line_end": 49
          },
          {
            "file": "references/api-docs.md",
            "line_start": 51,
            "line_end": 51
          },
          {
            "file": "references/api-docs.md",
            "line_start": 229,
            "line_end": 229
          },
          {
            "file": "references/api-docs.md",
            "line_start": 253,
            "line_end": 253
          },
          {
            "file": "references/api-docs.md",
            "line_start": 282,
            "line_end": 282
          },
          {
            "file": "references/api-docs.md",
            "line_start": 289,
            "line_end": 289
          },
          {
            "file": "references/api-docs.md",
            "line_start": 298,
            "line_end": 298
          },
          {
            "file": "references/api-docs.md",
            "line_start": 304,
            "line_end": 304
          },
          {
            "file": "references/changelogs.md",
            "line_start": 184,
            "line_end": 184
          },
          {
            "file": "references/changelogs.md",
            "line_start": 187,
            "line_end": 187
          },
          {
            "file": "references/changelogs.md",
            "line_start": 201,
            "line_end": 201
          },
          {
            "file": "references/changelogs.md",
            "line_start": 324,
            "line_end": 324
          },
          {
            "file": "references/technical-writing.md",
            "line_start": 161,
            "line_end": 161
          },
          {
            "file": "references/technical-writing.md",
            "line_start": 162,
            "line_end": 162
          },
          {
            "file": "references/technical-writing.md",
            "line_start": 163,
            "line_end": 163
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "references/api-docs.md",
            "line_start": 255,
            "line_end": 255
          },
          {
            "file": "references/api-docs.md",
            "line_start": 276,
            "line_end": 276
          },
          {
            "file": "references/api-docs.md",
            "line_start": 299,
            "line_end": 299
          },
          {
            "file": "references/api-docs.md",
            "line_start": 305,
            "line_end": 305
          },
          {
            "file": "references/api-documentation.template.md",
            "line_start": 244,
            "line_end": 244
          },
          {
            "file": "references/api-documentation.template.md",
            "line_start": 257,
            "line_end": 257
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:references/api-docs.md:267:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/api-docs.md",
        "line_start": 267,
        "line_end": 268,
        "snippet": "const userData = await client.get(`/users/${user.data.id}`);"
      },
      {
        "id": "network:references/api-docs.md:199:http-client-library",
        "category": "network",
        "severity": "low",
        "pattern": "HTTP client library",
        "file": "references/api-docs.md",
        "line_start": 199,
        "line_end": 199,
        "snippet": "-g typescript-axios \\"
      },
      {
        "id": "network:references/api-docs.md:250:http-client-library",
        "category": "network",
        "severity": "low",
        "pattern": "HTTP client library",
        "file": "references/api-docs.md",
        "line_start": 250,
        "line_end": 250,
        "snippet": "const axios = require('axios');"
      },
      {
        "id": "network:references/api-docs.md:252:http-client-library",
        "category": "network",
        "severity": "low",
        "pattern": "HTTP client library",
        "file": "references/api-docs.md",
        "line_start": 252,
        "line_end": 252,
        "snippet": "const client = axios.create({"
      },
      {
        "id": "network:references/api-docs.md:281:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/api-docs.md",
        "line_start": 281,
        "line_end": 281,
        "snippet": "response = requests.post("
      },
      {
        "id": "network:references/api-docs.md:288:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/api-docs.md",
        "line_start": 288,
        "line_end": 288,
        "snippet": "user = requests.get("
      },
      {
        "id": "network:references/api-docs.md:46:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 46,
        "line_end": 46,
        "snippet": "url: https://opensource.org/licenses/MIT"
      },
      {
        "id": "network:references/api-docs.md:49:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "- url: https://api.example.com/v1"
      },
      {
        "id": "network:references/api-docs.md:51:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 51,
        "line_end": 51,
        "snippet": "- url: https://staging-api.example.com/v1"
      },
      {
        "id": "network:references/api-docs.md:229:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 229,
        "line_end": 229,
        "snippet": "basePath: 'https://api.example.com/v1',"
      },
      {
        "id": "network:references/api-docs.md:253:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 253,
        "line_end": 253,
        "snippet": "baseURL: 'https://api.example.com/v1',"
      },
      {
        "id": "network:references/api-docs.md:282:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 282,
        "line_end": 282,
        "snippet": "'https://api.example.com/v1/users',"
      },
      {
        "id": "network:references/api-docs.md:289:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 289,
        "line_end": 289,
        "snippet": "f'https://api.example.com/v1/users/{response.json()[\"id\"]}',"
      },
      {
        "id": "network:references/api-docs.md:298:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 298,
        "line_end": 298,
        "snippet": "curl -X POST https://api.example.com/v1/users \\"
      },
      {
        "id": "network:references/api-docs.md:304:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-docs.md",
        "line_start": 304,
        "line_end": 304,
        "snippet": "curl https://api.example.com/v1/users/USER_ID \\"
      },
      {
        "id": "env_access:references/api-docs.md:255:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/api-docs.md",
        "line_start": 255,
        "line_end": 255,
        "snippet": "'Authorization': 'Bearer YOUR_API_KEY',"
      },
      {
        "id": "env_access:references/api-docs.md:276:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/api-docs.md",
        "line_start": 276,
        "line_end": 276,
        "snippet": "'Authorization': 'Bearer YOUR_API_KEY',"
      },
      {
        "id": "env_access:references/api-docs.md:299:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/api-docs.md",
        "line_start": 299,
        "line_end": 299,
        "snippet": "-H \"Authorization: Bearer YOUR_API_KEY\" \\"
      },
      {
        "id": "env_access:references/api-docs.md:305:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/api-docs.md",
        "line_start": 305,
        "line_end": 305,
        "snippet": "-H \"Authorization: Bearer YOUR_API_KEY\""
      },
      {
        "id": "blocker:references/api-docs.md:115:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/api-docs.md",
        "line_start": 115,
        "line_end": 115,
        "snippet": "description: Invalid request"
      },
      {
        "id": "blocker:references/api-docs.md:128:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/api-docs.md",
        "line_start": 128,
        "line_end": 129,
        "snippet": "format: uuid"
      },
      {
        "id": "blocker:references/api-docs.md:138:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/api-docs.md",
        "line_start": 138,
        "line_end": 139,
        "snippet": "- id"
      },
      {
        "id": "env_access:references/api-documentation.template.md:244:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/api-documentation.template.md",
        "line_start": 244,
        "line_end": 244,
        "snippet": "const client = new Client({ apiKey: '{{API_KEY}}' });"
      },
      {
        "id": "env_access:references/api-documentation.template.md:257:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/api-documentation.template.md",
        "line_start": 257,
        "line_end": 257,
        "snippet": "client = Client(api_key=\"{{API_KEY}}\")"
      },
      {
        "id": "blocker:references/api-documentation.template.md:182:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/api-documentation.template.md",
        "line_start": 182,
        "line_end": 182,
        "snippet": "| `unauthorized` | 401 | Invalid credentials |"
      },
      {
        "id": "external_commands:references/changelogs.md:184:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/changelogs.md",
        "line_start": 184,
        "line_end": 187,
        "snippet": "The `/api/v2/users` endpoint now requires authentication for all requests."
      },
      {
        "id": "external_commands:references/changelogs.md:187:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/changelogs.md",
        "line_start": 187,
        "line_end": 202,
        "snippet": "**Migration**: Add `Authorization: Bearer <token>` header to all API requests."
      },
      {
        "id": "network:references/changelogs.md:184:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/changelogs.md",
        "line_start": 184,
        "line_end": 184,
        "snippet": "The `/api/v2/users` endpoint now requires authentication for all requests."
      },
      {
        "id": "network:references/changelogs.md:187:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/changelogs.md",
        "line_start": 187,
        "line_end": 187,
        "snippet": "**Migration**: Add `Authorization: Bearer <token>` header to all API requests."
      },
      {
        "id": "network:references/changelogs.md:201:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/changelogs.md",
        "line_start": 201,
        "line_end": 201,
        "snippet": "**Full Changelog**: [View all commits](https://github.com/example/repo/compare/v2.4.0...v2.5.0)"
      },
      {
        "id": "network:references/changelogs.md:324:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/changelogs.md",
        "line_start": 324,
        "line_end": 324,
        "snippet": "**Full Changelog**: https://github.com/example/repo/compare/v2.4.0...v2.5.0"
      },
      {
        "id": "blocker:references/changelogs.md:291:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/changelogs.md",
        "line_start": 291,
        "line_end": 291,
        "snippet": "2. **Remove Jargon**: Avoid technical terms"
      },
      {
        "id": "blocker:references/migration-guide.template.md:278:network-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "Network reconnaissance",
        "file": "references/migration-guide.template.md",
        "line_start": 278,
        "line_end": 279,
        "snippet": "- [ ] All tests pass"
      },
      {
        "id": "external_commands:references/technical-writing.md:175:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/technical-writing.md",
        "line_start": 175,
        "line_end": 175,
        "snippet": "\\`\\`\\`bash"
      },
      {
        "id": "external_commands:references/technical-writing.md:177:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/technical-writing.md",
        "line_start": 177,
        "line_end": 177,
        "snippet": "\\`\\`\\`"
      },
      {
        "id": "external_commands:references/technical-writing.md:181:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/technical-writing.md",
        "line_start": 181,
        "line_end": 181,
        "snippet": "\\`\\`\\`javascript"
      },
      {
        "id": "external_commands:references/technical-writing.md:186:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/technical-writing.md",
        "line_start": 186,
        "line_end": 186,
        "snippet": "\\`\\`\\`"
      },
      {
        "id": "network:references/technical-writing.md:161:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/technical-writing.md",
        "line_start": 161,
        "line_end": 161,
        "snippet": "[![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://example.com)"
      },
      {
        "id": "network:references/technical-writing.md:162:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/technical-writing.md",
        "line_start": 162,
        "line_end": 162,
        "snippet": "[![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://example.com)"
      },
      {
        "id": "network:references/technical-writing.md:163:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/technical-writing.md",
        "line_start": 163,
        "line_end": 163,
        "snippet": "[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)"
      },
      {
        "id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 72,
        "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": 78,
        "snippet": "```"
      },
      {
        "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": 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": 88,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 88,
        "line_end": 92,
        "snippet": "```"
      },
      {
        "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": 94,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 94,
        "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": 98,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 98,
        "line_end": 123,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 123,
        "line_end": 143,
        "snippet": "```yaml"
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 143,
        "line_end": 241,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:241:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 241,
        "line_end": 243,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:243:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 243,
        "line_end": 245,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:245:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 245,
        "line_end": 247,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:247:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 247,
        "line_end": 249,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:249:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 249,
        "line_end": 251,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:251:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 251,
        "line_end": 255,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:255:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 255,
        "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": "```"
      },
      {
        "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": 264,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:264:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 264,
        "line_end": 268,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:268:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 268,
        "line_end": 289,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:289:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 289,
        "line_end": 295,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:295:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 295,
        "line_end": 296,
        "snippet": "- **`references/api_docs.md`** - API documentation patterns, OpenAPI specifications, SDK generation,"
      },
      {
        "id": "external_commands:SKILL.md:296:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 296,
        "line_end": 297,
        "snippet": "- **`references/technical_writing.md`** - Technical writing best practices, user guide structure, RE"
      },
      {
        "id": "external_commands:SKILL.md:297:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 297,
        "line_end": 298,
        "snippet": "- **`references/changelogs.md`** - Changelog generation patterns, commit categorization, user-friend"
      },
      {
        "id": "external_commands:SKILL.md:298:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 298,
        "line_end": 299,
        "snippet": "- **`references/API_DOCUMENTATION.template.md`** - REST API documentation template with endpoints, a"
      },
      {
        "id": "external_commands:SKILL.md:299:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 299,
        "line_end": 300,
        "snippet": "- **`references/CHANGELOG.template.md`** - Changelog template following Keep a Changelog format with"
      },
      {
        "id": "external_commands:SKILL.md:300:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 300,
        "line_end": 301,
        "snippet": "- **`references/DESIGN_SPEC.template.md`** - Design specification template for feature planning, tec"
      },
      {
        "id": "external_commands:SKILL.md:301:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 301,
        "line_end": 302,
        "snippet": "- **`references/ARCHITECTURE_DECISION_RECORD.template.md`** - ADR template for documenting significa"
      },
      {
        "id": "blocker:SKILL.md:193:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 193,
        "line_end": 193,
        "snippet": "- Avoid jargon when possible"
      },
      {
        "id": "blocker:SKILL.md:342:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 342,
        "line_end": 342,
        "snippet": "- **Plain Language**: Avoid unnecessary jargon"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:references/api-docs.md:267:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The match is a JavaScript template literal inside an API example. It is instructional sample code and not shell command execution by the skill."
      },
      {
        "id": "network:references/api-docs.md:199:http-client-library",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:250:http-client-library",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:252:http-client-library",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:281:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:288:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:46:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:49:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:51:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:229:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:253:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:282:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:289:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:298:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "network:references/api-docs.md:304:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The HTTP library or URL appears in API documentation examples using example.com. It documents client usage and does not make a live request itself."
      },
      {
        "id": "env_access:references/api-docs.md:255:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched token is a placeholder such as YOUR_API_KEY or {{API_KEY}} in documentation examples. No real secret value or environment access is present."
      },
      {
        "id": "env_access:references/api-docs.md:276:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched token is a placeholder such as YOUR_API_KEY or {{API_KEY}} in documentation examples. No real secret value or environment access is present."
      },
      {
        "id": "env_access:references/api-docs.md:299:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched token is a placeholder such as YOUR_API_KEY or {{API_KEY}} in documentation examples. No real secret value or environment access is present."
      },
      {
        "id": "env_access:references/api-docs.md:305:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched token is a placeholder such as YOUR_API_KEY or {{API_KEY}} in documentation examples. No real secret value or environment access is present."
      },
      {
        "id": "blocker:references/api-docs.md:115:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is part of an OpenAPI schema example, such as an error response, uuid field, or required id. It is not system reconnaissance."
      },
      {
        "id": "blocker:references/api-docs.md:128:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is part of an OpenAPI schema example, such as an error response, uuid field, or required id. It is not system reconnaissance."
      },
      {
        "id": "blocker:references/api-docs.md:138:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is part of an OpenAPI schema example, such as an error response, uuid field, or required id. It is not system reconnaissance."
      },
      {
        "id": "env_access:references/api-documentation.template.md:244:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched token is a placeholder such as YOUR_API_KEY or {{API_KEY}} in documentation examples. No real secret value or environment access is present."
      },
      {
        "id": "env_access:references/api-documentation.template.md:257:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched token is a placeholder such as YOUR_API_KEY or {{API_KEY}} in documentation examples. No real secret value or environment access is present."
      },
      {
        "id": "blocker:references/api-documentation.template.md:182:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is an API error-code table entry for invalid credentials. It describes expected API documentation content, not reconnaissance."
      },
      {
        "id": "external_commands:references/changelogs.md:184:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The match is prose in a sample changelog discussing an API migration. It is not a shell command or executable operation."
      },
      {
        "id": "external_commands:references/changelogs.md:187:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The match is prose in a sample changelog discussing an API migration. It is not a shell command or executable operation."
      },
      {
        "id": "network:references/changelogs.md:184:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL or API path appears in a sample changelog entry. It is static release-note text and does not initiate network activity."
      },
      {
        "id": "network:references/changelogs.md:187:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL or API path appears in a sample changelog entry. It is static release-note text and does not initiate network activity."
      },
      {
        "id": "network:references/changelogs.md:201:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL or API path appears in a sample changelog entry. It is static release-note text and does not initiate network activity."
      },
      {
        "id": "network:references/changelogs.md:324:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL or API path appears in a sample changelog entry. It is static release-note text and does not initiate network activity."
      },
      {
        "id": "blocker:references/changelogs.md:291:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is writing guidance that says to remove jargon. It has no system probing or reconnaissance behavior."
      },
      {
        "id": "blocker:references/migration-guide.template.md:278:network-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is a verification checklist item that says all tests pass. It is documentation structure, not network reconnaissance."
      },
      {
        "id": "external_commands:references/technical-writing.md:175:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is an escaped Markdown code fence in a README template. It is formatting guidance, not executable shell code."
      },
      {
        "id": "external_commands:references/technical-writing.md:177:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is an escaped Markdown code fence in a README template. It is formatting guidance, not executable shell code."
      },
      {
        "id": "external_commands:references/technical-writing.md:181:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is an escaped Markdown code fence in a README template. It is formatting guidance, not executable shell code."
      },
      {
        "id": "external_commands:references/technical-writing.md:186:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is an escaped Markdown code fence in a README template. It is formatting guidance, not executable shell code."
      },
      {
        "id": "network:references/technical-writing.md:161:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL appears in a README badge template, not in executable code. It is example documentation content with no network request by the skill."
      },
      {
        "id": "network:references/technical-writing.md:162:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL appears in a README badge template, not in executable code. It is example documentation content with no network request by the skill."
      },
      {
        "id": "network:references/technical-writing.md:163:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL appears in a README badge template, not in executable code. It is example documentation content with no network request by the skill."
      },
      {
        "id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:74:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:241:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:243:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:245:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:247:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:249:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:251:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:255:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:257:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:261:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:264:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:268:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:289:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:295:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:296:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:297:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:298:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:299:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:300:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "external_commands:SKILL.md:301:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown prompt block, code fence, or inline filename reference in the skill instructions. It is not Ruby backtick execution or runtime command execution."
      },
      {
        "id": "blocker:SKILL.md:193:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is plain-language writing guidance. It does not instruct the model to inspect systems or gather reconnaissance data."
      },
      {
        "id": "blocker:SKILL.md:342:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The matched text is plain-language writing guidance. It does not instruct the model to inspect systems or gather reconnaissance data."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 9,
    "total_lines": 2775,
    "audit_model": "codex",
    "audited_at": "2026-07-05T12:05:57.364Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Create Complete Technical Documentation",
    "value_statement": "Technical teams need clear docs across APIs, releases, and migrations. This skill creates structured documentation with templates and practical examples.",
    "seo_keywords": [
      "Claude documentation skill",
      "Codex documentation assistant",
      "Claude Code technical writing",
      "API documentation generator",
      "OpenAPI documentation",
      "changelog generator",
      "migration guide template",
      "architecture decision records",
      "developer documentation",
      "technical writing templates"
    ],
    "actual_capabilities": [
      "Creates OpenAPI and Swagger-style API documentation structures.",
      "Writes developer guides, user guides, tutorials, and README content.",
      "Generates changelog and release-note drafts from commit context.",
      "Creates migration guides with upgrade steps, rollback notes, and verification checklists.",
      "Documents architecture decisions, design specifications, and technical rationale.",
      "Provides reusable templates for common engineering documentation formats."
    ],
    "limitations": [
      "Requires accurate project context, API details, or commit history from the user.",
      "Generated examples should be reviewed and tested before publication.",
      "Does not validate live APIs unless the host agent is given separate tools and permission.",
      "Placeholder URLs, tokens, and package names must be replaced before use."
    ],
    "use_cases": [
      {
        "title": "Document a new API release",
        "description": "Create endpoint references, authentication notes, examples, and versioning guidance for a public or internal API.",
        "target_user": "API engineers"
      },
      {
        "title": "Prepare customer release notes",
        "description": "Turn technical commits into clear changelog entries grouped by features, fixes, improvements, and breaking changes.",
        "target_user": "Product managers"
      },
      {
        "title": "Plan an upgrade path",
        "description": "Create migration documentation with prerequisites, breaking changes, upgrade steps, rollback guidance, and validation checks.",
        "target_user": "Engineering leads"
      }
    ],
    "prompt_templates": [
      {
        "title": "Create a README",
        "scenario": "Beginner documentation task for a project landing page.",
        "prompt": "Create a README for this project. Include the purpose, installation steps, quick start, main features, configuration, troubleshooting, and license notes."
      },
      {
        "title": "Document API endpoints",
        "scenario": "Intermediate task for endpoint reference documentation.",
        "prompt": "Create API documentation for these endpoints. Include authentication, request parameters, response fields, error cases, examples, and versioning notes."
      },
      {
        "title": "Write a migration guide",
        "scenario": "Advanced task for version upgrades and breaking changes.",
        "prompt": "Write a migration guide from version A to version B. Include prerequisites, breaking changes, step-by-step upgrade instructions, rollback steps, and verification checks."
      },
      {
        "title": "Generate release documentation",
        "scenario": "Advanced task using commit history and a release style guide.",
        "prompt": "Generate customer-facing release notes from these commits. Group changes by impact, rewrite technical language, call out breaking changes, and follow this style guide."
      }
    ],
    "output_examples": [
      {
        "input": "Create API docs for user and workspace endpoints.",
        "output": "A structured API reference with endpoint summaries, authentication requirements, parameters, response descriptions, errors, and usage examples."
      },
      {
        "input": "Generate a changelog from the last release commits.",
        "output": "Customer-facing release notes grouped into new features, improvements, fixes, security updates, and breaking changes."
      },
      {
        "input": "Write a migration guide for a major version upgrade.",
        "output": "An upgrade guide with prerequisites, changed behavior, ordered migration steps, rollback instructions, and a verification checklist."
      }
    ],
    "best_practices": [
      "Provide real project context, target audience, and publishing format before requesting documentation.",
      "Review generated examples against the current codebase before sharing them externally.",
      "Keep generated documentation close to source changes so updates stay accurate."
    ],
    "anti_patterns": [
      "Do not publish placeholder credentials, URLs, package names, or commands without review.",
      "Do not ask for broad documentation without source material or audience details.",
      "Do not treat generated release notes as final without product and engineering review."
    ],
    "faq": [
      {
        "question": "Can this skill create OpenAPI documentation?",
        "answer": "Yes. It can draft OpenAPI-style structures, endpoint descriptions, schemas, authentication notes, and examples from provided API details."
      },
      {
        "question": "Can it generate changelogs from commits?",
        "answer": "Yes. It can organize commit context into customer-facing release notes and changelog sections."
      },
      {
        "question": "Does it execute SDK generators?",
        "answer": "No. It provides guidance and documentation patterns, but execution depends on the host agent and user permission."
      },
      {
        "question": "Is it useful for non-API documentation?",
        "answer": "Yes. It also supports README files, user guides, tutorials, design specs, ADRs, and migration guides."
      },
      {
        "question": "What information should I provide?",
        "answer": "Provide the audience, source material, product behavior, API details, version changes, and any style requirements."
      },
      {
        "question": "Should generated docs be reviewed?",
        "answer": "Yes. Review examples, commands, links, and release notes before publishing them to users."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "api-docs.md",
          "type": "file",
          "path": "references/api-docs.md",
          "lines": 379
        },
        {
          "name": "api-documentation.template.md",
          "type": "file",
          "path": "references/api-documentation.template.md",
          "lines": 304
        },
        {
          "name": "architecture-decision-record.template.md",
          "type": "file",
          "path": "references/architecture-decision-record.template.md",
          "lines": 181
        },
        {
          "name": "CHANGELOG.template.md",
          "type": "file",
          "path": "references/CHANGELOG.template.md",
          "lines": 157
        },
        {
          "name": "changelogs.md",
          "type": "file",
          "path": "references/changelogs.md",
          "lines": 360
        },
        {
          "name": "design-spec.template.md",
          "type": "file",
          "path": "references/design-spec.template.md",
          "lines": 322
        },
        {
          "name": "migration-guide.template.md",
          "type": "file",
          "path": "references/migration-guide.template.md",
          "lines": 309
        },
        {
          "name": "technical-writing.md",
          "type": "file",
          "path": "references/technical-writing.md",
          "lines": 390
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 373
    }
  ]
}
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