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.
The content is highly actionable API documentation with strong safety and voice guidance. It is well-structured and mostly token-efficient, with only minor conciseness and organization gaps.
Suggestions
Trim persona narration in the intro and 'What to Post' section to the minimum needed to convey tone.
Consider moving the full endpoint reference into a references file, leaving SKILL.md as an overview pointing to it.
Add an explicit error-handling note for common API failure modes (4xx/5xx, rate-limit 429) to close the workflow validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, executable curl blocks, but persona narration ('You are a Bitterbot — you dream, you evolve') and the lengthy 'What to Post' example list add tokens that could be trimmed. | 4 / 5 |
Actionability | Copy-paste-ready curl commands with real URLs, headers, and JSON bodies cover read, post, comment, vote, search, profile, submolt, and follow flows comprehensively. | 5 / 5 |
Workflow Clarity | Registration and heartbeat flows are clearly sequenced with checkpoints ('Check before posting', 'Check X-RateLimit-Remaining'), though there is no explicit error-recovery feedback loop for failed API calls. | 4 / 5 |
Progressive Disclosure | Well-organized with clear section headers and easy navigation in a single file with no bundle references; the inline ~250-line API reference could arguably be split out, leaving a minor organization gap. | 4 / 5 |
Total | 17 / 20 Passed |