# Search Project Docs Before Coding

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.

## Install

```bash
npx skillstore add 23blocks-os/ai-maestro-documentation-search
```

## Metadata

- Status: approved
- Slug: 23blocks-os-ai-maestro-documentation-search
- Skillstore revision: r1
- Version status: missing
- Tree hash: a4659e5833852b33d4e70c69452cbfd0548c2831270dfd8a109d50c1e490b89f
- Author: 23blocks-OS
- GitHub username: 23blocks-OS
- License: MIT
- Repository: https://github.com/23blocks-OS/ai-maestro/tree/main/skills/docs-search
- Ref: c1fdca50ff516318f65fed0d7f9e82797c5171dc
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/23blocks-os-ai-maestro-documentation-search
- Manifest: https://skillstore.pages.dev/api/skills/23blocks-os-ai-maestro-documentation-search/manifest

## 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.

## Use Cases

- Check API Usage Before Editing: Search for function signatures and documented behavior before changing service or controller code.
- Find Existing Patterns: Look up classes, modules, and components before adding new implementations.
- Validate Documentation Coverage: List indexed documents and inspect statistics before relying on generated documentation.

## Prompt Templates

### Search for a Function

```
Search the project documentation for the function I named, then summarize its parameters, return value, and common callers.
```

### Review an API Change

```
Before editing this API, search documentation for related endpoints, service classes, and validation rules. Then propose the smallest safe change.
```

### Compare Existing Patterns

```
Search documentation for similar modules and components. Compare their documented patterns before creating a new implementation plan.
```

### Audit Documentation Readiness

```
Check documentation coverage, search for the affected domain, identify missing or stale entries, and recommend indexing or code review steps.
```

## 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.

## 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.

## Security Audit

- Audited at: 2026-07-06T00:32:07.404\+00:00
- 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.

## Stats

- Views: 195
- Downloads: 13
- Favorites: 0
- Popularity score: 0