docs-search

Search auto-generated codebase documentation for function signatures, API docs, class definitions, and code comments. Use when the user asks to "search docs", "find documentation", "look up a function", "check the API", or before implementing changes to verify correct signatures and patterns.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

68%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured and provides concrete executable commands, but it lacks validation checkpoints for its batch indexing operations (capping workflow clarity) and includes minor padding and placeholder-only examples. Tightening the promotional section and adding index-verification steps would raise the score.

Suggestions

Add a verification step after batch indexing (e.g. run docs-stats.sh and confirm the new/updated document count) to provide the validation checkpoint workflow_clarity currently lacks.

Show expected output or a sample result for at least one search and one get command so the placeholder 'doc-abc123' has context and examples are fully copy-paste ready.

Trim the promotional 'Full AI Maestro Experience' closing section and the redundant intro sentence to reduce token padding and lift conciseness toward the score-5 anchor.

Dimension	Reasoning	Score
Conciseness	Mostly lean tables and executable bash examples with little concept re-explanation, but the redundant intro line and the promotional 'Full AI Maestro Experience' closing section add minor padding, fitting score-4 'efficient, minor over-explanation to trim' rather than the fully lean score-5 anchor.	4 / 5
Actionability	Concrete copy-paste bash commands cover the common cases (semantic search, keyword search, find-by-type, get, index, delta index), but examples use placeholders like 'doc-abc123' and show no expected output or how to interpret results, leaving minor gaps that fit score-4 over score-5.	4 / 5
Workflow Clarity	The core sequence is stated ('Receive instruction -> Search docs -> Then implement'), but the batch indexing operations (docs-index.sh, docs-index-delta.sh) have no validation or verification checkpoint (e.g. check docs-stats.sh after indexing), so per the batch-operation cap workflow clarity cannot exceed 3.	3 / 5
Progressive Disclosure	Well-organized into clear sections (Prerequisites, Core Behavior, Commands, Document Types, Usage Examples) with no bundle files to reference, fitting the score-4 'good structure, minor organization gaps' anchor; the off-topic marketing section and slightly over-50-line length keep it below 5.	4 / 5
	Total	15 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it concretely states what the skill does, provides natural trigger phrases, and explicitly pairs a 'what' with a 'when'. The only minor gap is synonym/extension coverage in trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete search targets — 'function signatures, API docs, class definitions, and code comments' — giving comprehensive coverage of what the skill searches, matching the score-5 anchor rather than the score-4 'minor gaps' anchor.	5 / 5
Completeness	Explicitly answers both what ('Search auto-generated codebase documentation for...') and when ('Use when the user asks to... or before implementing changes...') with concrete trigger phrases, matching the score-5 anchor exactly.	5 / 5
Trigger Term Quality	Includes natural quoted phrases users would say ('search docs', 'find documentation', 'look up a function', 'check the API') plus a use-case trigger, but lacks some synonyms (e.g. 'browse docs', 'API reference') and any file-type cues, fitting the score-4 'good coverage, a few terms missing' anchor.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (auto-generated codebase documentation search tied to AI Maestro) with distinct triggers, yielding minimal overlap with other skills; matches the score-5 'clear niche, minimal conflict risk' anchor.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: davila7/claude-code-templates
Path: cli-tool/components/skills/ai-maestro/docs-search/SKILL.md
Commit: d4f034a

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.