Content
67%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.
The body is a tight, actionable runbook: concrete commands, a bounded workflow, clear constraints, and error handling. Its main weaknesses are the ambiguous dual-package install section and a small execution gap in the jq parsing step.
Suggestions
Pick one recommended install path and demote the alternative to a parenthetical, removing the unexplained "Node.js 18+ (for action menus)" prerequisite.
Show the actual jq filter for step 3 (e.g., `aichat search --json -n 10 "[query]" | jq -r '.[] | "\(.session_id) \(.created): \(.snippet)"'`) so parsing is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, command-first prose, but the error-handling section offers two alternative packages ("uv tool install claude-code-tools" / "cargo install aichat-search") with no guidance on choosing between them, plus tangential curl installers and a prerequisite ("Node.js 18+ (for action menus)") referencing a feature never explained. Not 2 because the core workflow is efficient and unpadded; not 4 because the install block's choice-parity and stray prerequisite are unnecessary content. | 3 / 5 |
Actionability | Concrete executable commands appear throughout — `aichat search --json -n 10 "[query]"` with the `-g "project"` filter, the session-file path pattern `~/.claude/projects/*/[session-id].jsonl`, and a worked example. Not 5 because step 3 says "Use `jq` to extract fields" without showing the actual jq expression, leaving a small execution gap. | 4 / 5 |
Workflow Clarity | The five-step workflow is clearly sequenced (understand → search → parse → deep-dive with a 3-file cap → summarize) and includes error-recovery paths ("If no results found, suggest alternative search terms" and the command-failure handling section). Not 5 because checkpoints are implicit in the step list rather than embedded as explicit validation steps; the read-only nature of the skill means no destructive/batch cap applies. | 4 / 5 |
Progressive Disclosure | Sections are clean and well-labeled (Workflow, Output Format, Example, Constraints, Error Handling) and the skill is appropriately self-contained with no bundle files or nested references. Not 5 because the ~74-line body exceeds the under-50-line simple-skill exception and the install/prerequisites block is a minor organization gap mixing recovery guidance with environment setup. | 4 / 5 |
Total | 15 / 20 Passed |