Content
86%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 well-built read-only skill body: executable curl examples with exact endpoints, fields, and defaults, organized in a clear 4-step workflow with an API-key checkpoint and a properly signaled single reference file. Weak spots are mild redundancy between the body and the reference (answer patterns, cross-source blocks) and the absence of any response-error validation step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean — a mapping table plus copy-paste curl commands with no conceptual padding (no explanation of what sentiment or an API is). Minor fat: the opening 'Use it when the user wants' list restates the description, and Step 4's answer patterns plus the multi-source curl block partially duplicate 'references/api_reference.md'. Efficient but could be trimmed slightly. | 4 / 5 |
Actionability | Fully executable guidance: concrete curl commands per source ('curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"'), exact field names ('mentions' vs 'trade_count'), explicit defaults ('days=7', '1..10 tickers'), and a copy-ready output template. Common cases (single-source, multi-source snapshot, multi-ticker) are all covered. | 5 / 5 |
Workflow Clarity | Clear 4-step sequence (check key → map request to endpoint → execute → present) with an explicit checkpoint in Step 1 (detect ADANOS_API_KEY_MISSING and remediate). The destructive/batch cap does not apply since the skill is read-only. Not a 5 because there is no validation of API responses (error/empty/missing-source handling beyond rule 5's one-liner) and no feedback loop if a request fails. | 4 / 5 |
Progressive Disclosure | Clear overview with a single well-signaled, one-level-deep reference: 'references/api_reference.md - endpoint guide, field meanings, and example workflows... Read the reference file when you need the exact field names, query parameters, or recommended answer patterns.' The referenced file exists, is one level deep, and the split is appropriate — compact patterns inline, full field/parameter detail in the reference. | 5 / 5 |
Total | 18 / 20 Passed |