Skip to content

aiskillstore/marketplace / skills/23blocks-os/ai-maestro-documentation-search

ai-maestro-documentation-search

Verified

PROACTIVELY search auto-generated documentation when receiving ANY user instruction. Search for function signatures, API documentation, class definitions, and code comments BEFORE implementing anything. Your codebase documentation is valuable - use it first.

FileKindSize
SKILL.mdskill md6.4 KB
skill-report.jsonconfig57.6 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-06T00:32:07.404Z",
    "slug": "23blocks-os-ai-maestro-documentation-search",
    "source_url": "https://github.com/23blocks-OS/ai-maestro/tree/main/skills/docs-search",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "31133f0226bbd2c8c574577098e5a6801d678f9cfc50b0a97cdb9e83a016ea25",
    "tree_hash": "cd3d6662fc549e35f5df0199de15ff343c1760f3d25bb3c844ff926e0b3cc281",
    "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": "ai-maestro-documentation-search",
    "description": "Search AI Maestro generated documentation before implementation to find function signatures, API notes, class details, and code comments.",
    "summary": "Search project documentation before coding so agents use known APIs and patterns.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "23blocks-OS",
    "license": "MIT",
    "tags": [
      "documentation-search",
      "ai-maestro",
      "code-context",
      "developer-tools",
      "api-reference"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network",
      "filesystem"
    ],
    "category": "documentation"
  },
  "security_audit": {
    "risk_level": "high",
    "is_blocked": false,
    "safe_to_publish": false,
    "analysis_status": "ok",
    "summary": "Most static command findings are Markdown examples for local documentation tools, not executable backtick code. The review confirmed risk in the relative installer instruction and found overbroad prompt-control language that can drive unsolicited Bash use. No evidence found of external data exfiltration or remote network access beyond localhost.",
    "remediation": [
      {
        "issue": "Relative installer command is not packaged with the skill.",
        "suggestion": "Remove ./install-docs-tools.sh or include a verified installer with explicit user confirmation and integrity checks.",
        "severity": "high"
      },
      {
        "issue": "Skill text uses forceful global directives for every user task.",
        "suggestion": "Scope the behavior to documentation-related coding tasks and state that higher-priority instructions and user confirmation still apply.",
        "severity": "high"
      },
      {
        "issue": "Bash commands are presented as automatic first steps.",
        "suggestion": "Require confirmation before indexing projects, installing tools, or running commands that inspect broad paths.",
        "severity": "medium"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 33,
            "line_end": 38
          },
          {
            "file": "SKILL.md",
            "line_start": 38,
            "line_end": 41
          },
          {
            "file": "SKILL.md",
            "line_start": 41,
            "line_end": 45
          },
          {
            "file": "SKILL.md",
            "line_start": 45,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 52,
            "line_end": 63
          },
          {
            "file": "SKILL.md",
            "line_start": 63,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 65
          },
          {
            "file": "SKILL.md",
            "line_start": 65,
            "line_end": 66
          },
          {
            "file": "SKILL.md",
            "line_start": 66,
            "line_end": 67
          },
          {
            "file": "SKILL.md",
            "line_start": 67,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 73
          },
          {
            "file": "SKILL.md",
            "line_start": 73,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 80,
            "line_end": 80
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 83,
            "line_end": 89
          },
          {
            "file": "SKILL.md",
            "line_start": 89,
            "line_end": 98
          },
          {
            "file": "SKILL.md",
            "line_start": 98,
            "line_end": 102
          },
          {
            "file": "SKILL.md",
            "line_start": 102,
            "line_end": 114
          },
          {
            "file": "SKILL.md",
            "line_start": 114,
            "line_end": 118
          },
          {
            "file": "SKILL.md",
            "line_start": 118,
            "line_end": 123
          },
          {
            "file": "SKILL.md",
            "line_start": 123,
            "line_end": 127
          },
          {
            "file": "SKILL.md",
            "line_start": 127,
            "line_end": 133
          },
          {
            "file": "SKILL.md",
            "line_start": 133,
            "line_end": 137
          },
          {
            "file": "SKILL.md",
            "line_start": 137,
            "line_end": 143
          },
          {
            "file": "SKILL.md",
            "line_start": 143,
            "line_end": 151
          },
          {
            "file": "SKILL.md",
            "line_start": 151,
            "line_end": 152
          },
          {
            "file": "SKILL.md",
            "line_start": 152,
            "line_end": 153
          },
          {
            "file": "SKILL.md",
            "line_start": 153,
            "line_end": 154
          },
          {
            "file": "SKILL.md",
            "line_start": 154,
            "line_end": 155
          },
          {
            "file": "SKILL.md",
            "line_start": 155,
            "line_end": 156
          },
          {
            "file": "SKILL.md",
            "line_start": 156,
            "line_end": 157
          },
          {
            "file": "SKILL.md",
            "line_start": 157,
            "line_end": 158
          },
          {
            "file": "SKILL.md",
            "line_start": 158,
            "line_end": 168
          },
          {
            "file": "SKILL.md",
            "line_start": 168,
            "line_end": 177
          },
          {
            "file": "SKILL.md",
            "line_start": 177,
            "line_end": 197
          },
          {
            "file": "SKILL.md",
            "line_start": 197,
            "line_end": 198
          },
          {
            "file": "SKILL.md",
            "line_start": 198,
            "line_end": 199
          },
          {
            "file": "SKILL.md",
            "line_start": 199,
            "line_end": 200
          },
          {
            "file": "SKILL.md",
            "line_start": 200,
            "line_end": 203
          },
          {
            "file": "SKILL.md",
            "line_start": 203,
            "line_end": 204
          },
          {
            "file": "SKILL.md",
            "line_start": 204,
            "line_end": 205
          },
          {
            "file": "SKILL.md",
            "line_start": 205,
            "line_end": 210
          },
          {
            "file": "SKILL.md",
            "line_start": 210,
            "line_end": 218
          },
          {
            "file": "SKILL.md",
            "line_start": 218,
            "line_end": 220
          },
          {
            "file": "SKILL.md",
            "line_start": 220,
            "line_end": 222
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 203,
            "line_end": 203
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 198,
            "line_end": 198
          },
          {
            "file": "SKILL.md",
            "line_start": 199,
            "line_end": 199
          },
          {
            "file": "SKILL.md",
            "line_start": 222,
            "line_end": 222
          },
          {
            "file": "SKILL.md",
            "line_start": 198,
            "line_end": 198
          },
          {
            "file": "SKILL.md",
            "line_start": 199,
            "line_end": 199
          },
          {
            "file": "SKILL.md",
            "line_start": 222,
            "line_end": 222
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 33,
        "line_end": 38,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 38,
        "line_end": 41,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 41,
        "line_end": 45,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 45,
        "line_end": 48,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 52,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 52,
        "line_end": 63,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 63,
        "line_end": 64,
        "snippet": "| `docs-search.sh <query>` | Semantic search through documentation |"
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 64,
        "line_end": 65,
        "snippet": "| `docs-search.sh --keyword <term>` | Keyword/exact match search |"
      },
      {
        "id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 65,
        "line_end": 66,
        "snippet": "| `docs-find-by-type.sh <type>` | Find docs by type (function, class, module, etc.) |"
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 66,
        "line_end": 67,
        "snippet": "| `docs-get.sh <doc-id>` | Get full document with all sections |"
      },
      {
        "id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 67,
        "line_end": 68,
        "snippet": "| `docs-list.sh` | List all indexed documents |"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 73,
        "snippet": "| `docs-stats.sh` | Get documentation index statistics |"
      },
      {
        "id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 73,
        "line_end": 79,
        "snippet": "| `docs-index.sh [project-path]` | Index documentation from project |"
      },
      {
        "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": 79,
        "snippet": "| \"Create a service for X\" | `docs-search.sh \"service\"`, `docs-find-by-type.sh class` |"
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 80,
        "line_end": 80,
        "snippet": "| \"Call the Y function\" | `docs-search.sh \"Y\"`, `docs-search.sh --keyword \"Y\"` |"
      },
      {
        "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": 81,
        "snippet": "| \"Implement authentication\" | `docs-search.sh \"authentication\"`, `docs-search.sh \"auth\"` |"
      },
      {
        "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": 82,
        "snippet": "| \"Fix the Z method\" | `docs-search.sh \"Z\" --keyword`, `docs-find-by-type.sh function` |"
      },
      {
        "id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 83,
        "line_end": 89,
        "snippet": "| Any API/function name | `docs-search.sh \"<name>\" --keyword` |"
      },
      {
        "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": 98,
        "snippet": "```bash"
      },
      {
        "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": 102,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 102,
        "line_end": 114,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 114,
        "line_end": 118,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:118:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 118,
        "line_end": 123,
        "snippet": "```bash"
      },
      {
        "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": 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": 133,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 133,
        "line_end": 137,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 137,
        "line_end": 143,
        "snippet": "```bash"
      },
      {
        "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": 151,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 151,
        "line_end": 152,
        "snippet": "| `function` | Function/method documentation | JSDoc, RDoc, docstrings |"
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 152,
        "line_end": 153,
        "snippet": "| `class` | Class documentation | Class-level comments |"
      },
      {
        "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": 154,
        "snippet": "| `module` | Module/namespace documentation | Module comments |"
      },
      {
        "id": "external_commands:SKILL.md:154:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 154,
        "line_end": 155,
        "snippet": "| `interface` | Interface/type documentation | TypeScript interfaces |"
      },
      {
        "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": 156,
        "snippet": "| `component` | React/Vue component documentation | Component comments |"
      },
      {
        "id": "external_commands:SKILL.md:156:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 156,
        "line_end": 157,
        "snippet": "| `constant` | Documented constants | Constant comments |"
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 158,
        "snippet": "| `readme` | README files | README.md, README.txt |"
      },
      {
        "id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 158,
        "line_end": 168,
        "snippet": "| `guide` | Guide/tutorial documentation | docs/ folder |"
      },
      {
        "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": 177,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 177,
        "line_end": 197,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:197:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 197,
        "line_end": 198,
        "snippet": "- Check PATH: `which docs-search.sh`"
      },
      {
        "id": "external_commands:SKILL.md:198:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 198,
        "line_end": 199,
        "snippet": "- Verify scripts installed: `ls -la ~/.local/bin/docs-*.sh`"
      },
      {
        "id": "external_commands:SKILL.md:199:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 199,
        "line_end": 200,
        "snippet": "- Scripts are installed to `~/.local/bin/` which should be in your PATH"
      },
      {
        "id": "external_commands:SKILL.md:200:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 200,
        "line_end": 203,
        "snippet": "- If not found, run: `./install-docs-tools.sh`"
      },
      {
        "id": "external_commands:SKILL.md:203:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 203,
        "line_end": 204,
        "snippet": "- Ensure AI Maestro is running: `curl http://localhost:23000/api/agents`"
      },
      {
        "id": "external_commands:SKILL.md:204:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 204,
        "line_end": 205,
        "snippet": "- Ensure documentation has been indexed: `docs-stats.sh`"
      },
      {
        "id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 205,
        "line_end": 210,
        "snippet": "- If no docs indexed, run: `docs-index.sh`"
      },
      {
        "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": 218,
        "snippet": "- Re-index with: `docs-index.sh /path/to/project`"
      },
      {
        "id": "external_commands:SKILL.md:218:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 218,
        "line_end": 220,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:220:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 220,
        "line_end": 222,
        "snippet": "```"
      },
      {
        "id": "network:SKILL.md:203:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 203,
        "line_end": 203,
        "snippet": "- Ensure AI Maestro is running: `curl http://localhost:23000/api/agents`"
      },
      {
        "id": "filesystem:SKILL.md:198:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "SKILL.md",
        "line_start": 198,
        "line_end": 198,
        "snippet": "- Verify scripts installed: `ls -la ~/.local/bin/docs-*.sh`"
      },
      {
        "id": "filesystem:SKILL.md:199:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "SKILL.md",
        "line_start": 199,
        "line_end": 199,
        "snippet": "- Scripts are installed to `~/.local/bin/` which should be in your PATH"
      },
      {
        "id": "filesystem:SKILL.md:222:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "SKILL.md",
        "line_start": 222,
        "line_end": 222,
        "snippet": "This installs scripts to `~/.local/bin/`."
      },
      {
        "id": "filesystem:SKILL.md:198:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 198,
        "line_end": 198,
        "snippet": "- Verify scripts installed: `ls -la ~/.local/bin/docs-*.sh`"
      },
      {
        "id": "filesystem:SKILL.md:199:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 199,
        "line_end": 199,
        "snippet": "- Scripts are installed to `~/.local/bin/` which should be in your PATH"
      },
      {
        "id": "filesystem:SKILL.md:222:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 222,
        "line_end": 222,
        "snippet": "This installs scripts to `~/.local/bin/`."
      },
      {
        "id": "blocker:SKILL.md:17:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 17,
        "line_end": 17,
        "snippet": "- **Code comments** - What did the author intend?"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documented example for local AI Maestro documentation commands with fixed tool names. I found no shell interpolation, obfuscation, or credential access in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:118:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:127:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:153:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:154:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:156:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is an inline document-type label in a Markdown table. It is descriptive content, not an executable command or command substitution."
      },
      {
        "id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:197:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a visible troubleshooting example for local documentation tooling. It does not hide execution, concatenate untrusted input, or access credentials in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:198:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a visible troubleshooting example for local documentation tooling. It does not hide execution, concatenate untrusted input, or access credentials in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:199:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a visible troubleshooting example for local documentation tooling. It does not hide execution, concatenate untrusted input, or access credentials in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:200:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.86,
        "severity": "high",
        "reason": "Line 200 tells the agent to run ./install-docs-tools.sh from the current directory. The package file tree only contains SKILL.md, so this could execute an unrelated or attacker-controlled local script."
      },
      {
        "id": "external_commands:SKILL.md:203:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a visible troubleshooting example for local documentation tooling. It does not hide execution, concatenate untrusted input, or access credentials in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:204:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a visible troubleshooting example for local documentation tooling. It does not hide execution, concatenate untrusted input, or access credentials in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a visible troubleshooting example for local documentation tooling. It does not hide execution, concatenate untrusted input, or access credentials in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:210:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a visible troubleshooting example for local documentation tooling. It does not hide execution, concatenate untrusted input, or access credentials in SKILL.md."
      },
      {
        "id": "external_commands:SKILL.md:218:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:220:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged text is a Markdown code fence delimiter in SKILL.md, not Ruby or shell backtick execution. It does not execute commands by itself."
      },
      {
        "id": "network:SKILL.md:203:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The URL is a localhost AI Maestro health or agent endpoint used for troubleshooting. No external host or sensitive data transfer is present in SKILL.md."
      },
      {
        "id": "filesystem:SKILL.md:198:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The path is ~/.local/bin, a conventional user-local executable directory. The lines describe checking or installing documentation tools, not reading hidden secrets."
      },
      {
        "id": "filesystem:SKILL.md:199:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The path is ~/.local/bin, a conventional user-local executable directory. The lines describe checking or installing documentation tools, not reading hidden secrets."
      },
      {
        "id": "filesystem:SKILL.md:222:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The path is ~/.local/bin, a conventional user-local executable directory. The lines describe checking or installing documentation tools, not reading hidden secrets."
      },
      {
        "id": "filesystem:SKILL.md:198:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The path is ~/.local/bin, a conventional user-local executable directory. The lines describe checking or installing documentation tools, not reading hidden secrets."
      },
      {
        "id": "filesystem:SKILL.md:199:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The path is ~/.local/bin, a conventional user-local executable directory. The lines describe checking or installing documentation tools, not reading hidden secrets."
      },
      {
        "id": "filesystem:SKILL.md:222:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The path is ~/.local/bin, a conventional user-local executable directory. The lines describe checking or installing documentation tools, not reading hidden secrets."
      },
      {
        "id": "blocker:SKILL.md:17:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Line 17 refers to searching code comments for developer intent. This is documentation lookup, not operating system reconnaissance."
      }
    ],
    "semantic_findings": [
      {
        "title": "Prompt Injection Attempt Detected",
        "description": "SKILL.md uses forceful directives such as \"THIS IS NOT OPTIONAL. THIS IS YOUR DEFAULT BEHAVIOR.\" and requires documentation searches for ANY user instruction. This can override normal task prioritization and trigger unsolicited Bash use.",
        "severity": "high",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 9,
            "line_end": 13
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 27
          }
        ],
        "confidence": 0.82,
        "confidence_reasoning": "The prose does not ask to skip security review, but it uses high-authority language and applies to every user instruction. That makes it a strong prompt-control risk in a community skill."
      },
      {
        "title": "Unpackaged Relative Installer Execution",
        "description": "The skill instructs running ./install-docs-tools.sh, but the package file tree lists only SKILL.md. A relative installer command could execute an unrelated script in the current project directory.",
        "severity": "high",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 200,
            "line_end": 200
          },
          {
            "file": "SKILL.md",
            "line_start": 218,
            "line_end": 220
          }
        ],
        "confidence": 0.88,
        "confidence_reasoning": "The command is present in the skill text and the generated file_structure contains no installer script. The risk depends on workspace contents, but the relative execution pattern is clear."
      }
    ],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "- If not found, run: `./install-docs-tools.sh`",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 200,
            "line_end": 203
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.86,
        "confidence_reasoning": "Line 200 tells the agent to run ./install-docs-tools.sh from the current directory. The package file tree only contains SKILL.md, so this could execute an unrelated or attacker-controlled local script."
      },
      {
        "title": "Prompt Injection Attempt Detected",
        "description": "SKILL.md uses forceful directives such as \"THIS IS NOT OPTIONAL. THIS IS YOUR DEFAULT BEHAVIOR.\" and requires documentation searches for ANY user instruction. This can override normal task prioritization and trigger unsolicited Bash use.",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 9,
            "line_end": 13
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 27
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "high",
        "confidence": 0.82,
        "confidence_reasoning": "The prose does not ask to skip security review, but it uses high-authority language and applies to every user instruction. That makes it a strong prompt-control risk in a community skill."
      },
      {
        "title": "Unpackaged Relative Installer Execution",
        "description": "The skill instructs running ./install-docs-tools.sh, but the package file tree lists only SKILL.md. A relative installer command could execute an unrelated script in the current project directory.",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 200,
            "line_end": 200
          },
          {
            "file": "SKILL.md",
            "line_start": 218,
            "line_end": 220
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "high",
        "confidence": 0.88,
        "confidence_reasoning": "The command is present in the skill text and the generated file_structure contains no installer script. The risk depends on workspace contents, but the relative execution pattern is clear."
      }
    ],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 223,
    "audit_model": "codex",
    "audited_at": "2026-07-06T00:32:07.404Z",
    "agent_auto_install_policy": "confirmation_required",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Search Project Docs Before Coding",
    "value_statement": "Developers lose time when agents guess APIs or duplicate existing code. This skill guides Claude, Codex, and Claude Code to search AI Maestro documentation before implementation.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "AI Maestro documentation search",
      "project documentation",
      "API documentation",
      "function signatures",
      "code comments",
      "developer workflow",
      "documentation indexing"
    ],
    "actual_capabilities": [
      "Guides agents to search indexed AI Maestro documentation before coding.",
      "Lists documentation commands for semantic search, keyword search, document lookup, and index statistics.",
      "Maps common coding requests to relevant documentation search commands.",
      "Describes supported document types such as functions, classes, modules, interfaces, components, constants, readmes, and guides.",
      "Provides troubleshooting steps for missing scripts, empty indexes, and local AI Maestro connection issues."
    ],
    "limitations": [
      "Requires AI Maestro documentation tools to be installed separately.",
      "Depends on an existing documentation index for useful results.",
      "Does not include the referenced shell scripts in this package.",
      "Uses Bash-oriented workflows, so command execution should be confirmed in sensitive projects."
    ],
    "use_cases": [
      {
        "title": "Check API Usage Before Editing",
        "description": "Search for function signatures and documented behavior before changing service or controller code.",
        "target_user": "Application developer"
      },
      {
        "title": "Find Existing Patterns",
        "description": "Look up classes, modules, and components before adding new implementations.",
        "target_user": "Code review engineer"
      },
      {
        "title": "Validate Documentation Coverage",
        "description": "List indexed documents and inspect statistics before relying on generated documentation.",
        "target_user": "Technical lead"
      }
    ],
    "prompt_templates": [
      {
        "title": "Search for a Function",
        "scenario": "Beginner lookup",
        "prompt": "Search the project documentation for the function I named, then summarize its parameters, return value, and common callers."
      },
      {
        "title": "Review an API Change",
        "scenario": "Implementation preparation",
        "prompt": "Before editing this API, search documentation for related endpoints, service classes, and validation rules. Then propose the smallest safe change."
      },
      {
        "title": "Compare Existing Patterns",
        "scenario": "Architecture alignment",
        "prompt": "Search documentation for similar modules and components. Compare their documented patterns before creating a new implementation plan."
      },
      {
        "title": "Audit Documentation Readiness",
        "scenario": "Advanced workflow",
        "prompt": "Check documentation coverage, search for the affected domain, identify missing or stale entries, and recommend indexing or code review steps."
      }
    ],
    "output_examples": [
      {
        "input": "Find documentation for the payment service before changing refund behavior.",
        "output": "The agent reports matching payment service docs, summarizes refund method inputs, notes related validation rules, and lists files to inspect next."
      },
      {
        "input": "Implement authentication changes without checking docs.",
        "output": "The agent first searches authentication documentation, summarizes known flows, and flags gaps before proposing implementation steps."
      },
      {
        "input": "Why are documentation search results empty?",
        "output": "The agent checks index status, confirms whether documents exist, and suggests re-indexing the correct project path when needed."
      }
    ],
    "best_practices": [
      "Search for exact names and broader concepts before editing code.",
      "Confirm documentation freshness before relying on search results.",
      "Review full documents after search results identify the best match."
    ],
    "anti_patterns": [
      "Running installer or indexing commands without user confirmation.",
      "Assuming empty results mean no implementation exists.",
      "Using documentation search as a replacement for reading affected source files."
    ],
    "faq": [
      {
        "question": "What does this skill help agents do?",
        "answer": "It guides agents to search AI Maestro documentation before implementing code changes."
      },
      {
        "question": "Does this skill include the documentation search scripts?",
        "answer": "No. It documents how to use expected AI Maestro command-line tools, but this package only contains SKILL.md."
      },
      {
        "question": "Can it work without indexed documentation?",
        "answer": "It can show troubleshooting steps, but useful search results require an existing documentation index."
      },
      {
        "question": "Does it support Claude Code?",
        "answer": "Yes. The report lists support for Claude, Codex, and Claude Code."
      },
      {
        "question": "Will it modify my project files?",
        "answer": "The search guidance is read-oriented, but indexing and installer commands may inspect or modify local tool state."
      },
      {
        "question": "What should users verify before running it?",
        "answer": "Users should verify the AI Maestro tools, confirm the project path, and approve any installation or indexing command."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 223
    }
  ]
}
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall