Content
92%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.
An exemplary concise, action-first skill body: an exact executable command verified against the bundled script, documented arguments and output schema, and clean section organization with no filler or concept explanations. Only trivial trims (Use Cases duplication, redundant Dependencies section) keep it from full marks on conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: a one-line command, terse argument list, and an output schema with no concept explanations. Two minor trims exist — the 'Use Cases' section repeats trigger phrasing already covered by the description, and 'Dependencies' duplicates the frontmatter's dependency list — so it sits just below the 'every token earns its place' anchor. | 4 / 5 |
Actionability | "uv run python scripts/insider_trading.py SYMBOLS [--days DAYS]" is a fully executable command (verified: the script exists with exactly this CLI), with a python fallback note, documented arguments including default (90 days) and multi-symbol examples ('NVDA' or 'NVDA,PLTR,GOOG'), and a described JSON output shape. Copy-paste ready and covers the common cases. | 5 / 5 |
Workflow Clarity | This is a simple single-task skill (under 50 lines), and the single action is unambiguous: run the script with symbols and optional --days, then read the JSON output. The operation is read-only fetching (not destructive or state-changing), so no validation checkpoints are required, and the simple-skill exception applies cleanly. | 5 / 5 |
Progressive Disclosure | The skill is a short, single-file overview with well-organized sections (Instructions, Arguments, Output, Dependencies, Timezone) and no content that warrants separate reference files. Its one bundle path, scripts/insider_trading.py, is real, correctly referenced, and one level deep — matching the guideline that a small skill with no external references scores 5. | 5 / 5 |
Total | 19 / 20 Passed |