Content
80%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, highly actionable body with copy-paste commands, immutable-parameter warnings, and a well-structured one-level-deep reference bundle. The main weakness is the capped workflow clarity: batch vector ingestion (500 vectors/call) lacks an explicit verification step to confirm stored data before proceeding, and the Overview slightly duplicates reference content.
Suggestions
Add an explicit post-ingestion verification step after put-vectors (e.g., query or get-vectors on one stored key to confirm vectors landed before declaring success), which would lift workflow_clarity past the batch-operation cap.
Trim the Overview's latency/cost sentences ("subsecond latency for cold queries, as low as 100ms for warm queries") since references/limits-and-patterns.md already restates them, removing redundancy from the token budget.
Include a short failure-recovery loop for batch ingestion (check partial success, re-put failed keys, then re-verify) so the 429 backoff guidance becomes a full validate -> fix -> retry feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Efficient overall: terse MUST/SHOULD constraint lists, complete CLI commands, and a compact troubleshooting table with no padding of concepts Claude already knows. Not a 5 because the Overview duplicates latency/cost points ("subsecond latency... as low as 100ms") that are restated in references/limits-and-patterns.md, and a few constraint lines could be tightened. | 4 / 5 |
Actionability | Fully executable copy-paste CLI commands for every step (create-vector-bucket, create-index, put-vectors, query-vectors, bedrock-runtime invoke-model) with required flags, realistic JSON payloads for metadata configuration and filters, an example response body, and model-specific parsing guidance ("For Titan, parse with json.load(...)['embedding']"). Common cases including filtering and error recovery are covered by the troubleshooting table. | 5 / 5 |
Workflow Clarity | The 6-step sequence is clear with request classification, a pre-flight checklist for immutable parameters, and user-confirmation checkpoints ("confirm bucket name with user", "confirm with user -- destroys all vectors"). However, the batch put-vectors operation (up to 500 vectors per call) has no post-ingestion verification step (e.g., query or get-vectors to confirm stored data), and the rubric's hard cap for batch operations without validation/verification caps this at 3. Not a 2 because sequence and several checkpoints are clearly present. | 3 / 5 |
Progressive Disclosure | SKILL.md is a well-organized overview with two clearly signaled, one-level-deep references (limits-and-patterns.md, metadata-filtering.md), both of which exist and cover exactly what is claimed. Advanced content (multi-tenant patterns, batch ingestion, SSE-KMS command, filter operator tables) is appropriately split out, references are linked inline at the point of need and again in an annotated Additional Resources section, and the reference files point only to external AWS docs rather than nesting further files. | 5 / 5 |
Total | 17 / 20 Passed |