Content
82%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 high-quality, actionable reference skill: executable SQL templates, a concrete schema, and explicit read-only guardrails, all well-organized. Minor room to improve conciseness (deduplicate the two error-finding queries) and to split the schema/template bulk into a referenced file for cleaner progressive disclosure.
Suggestions
Merge or differentiate the two near-identical error-finding query templates ('Find repeated stdout errors' and 'Find actual tool failures') to trim tokens, or clearly state when each applies.
Move the schema table and/or the full query-template catalog into a references/ file (e.g. SCHEMA.md, QUERIES.md) and keep SKILL.md as a concise overview pointing to it, improving progressive disclosure for this >50-line skill.
Add a brief validation hint after running queries (e.g. confirm row counts / time range before trusting aggregated results) to strengthen workflow clarity even for read-only analysis.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes Claude's competence (no explanations of SQLite, JSON, or json_extract); the schema table, conventions, and six SQL templates all earn their place. Slightly long with two near-duplicate error-finding templates, so anchor 4 fits better than 5. | 4 / 5 |
Actionability | Six fully executable, copy-paste-ready SQL templates with clearly marked placeholders (<PROJECT_ID>, <SESSION_ID>, <TOOL_NAME>) cover the common cases (recent sessions, keyword search, tool calls, execution chain, repeated errors, tool failures), plus a concrete schema table and locating command. | 5 / 5 |
Workflow Clarity | Clear logical flow from When-to-use to Locating the database, Schema, Query templates, Search strategies, and Constraints. The skill is explicitly read-only ('Always use -readonly or only SELECT queries — never modify the database'), so the destructive/batch validation cap does not apply; minor validation gaps remain, fitting anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/scripts/assets absent) and all content is inline, but it is well-organized under clear section headers and navigable. The skill exceeds 50 lines so the simple-skill exception does not apply; the inlined schema/templates could arguably live in a reference file, putting it at anchor 4 rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |