Content
57%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's core strength is fully executable curl-based API documentation with concrete responses and limits, which is genuinely copy-paste ready. However, the SKILL.md is bloated by promotional and behavioral padding (community-motivation prose, a generic safety-policy restatement, redundant recap sections), the multi-step onboarding workflows contain contradictory and inconsistent steps, and the entire API reference is inlined where it should be split into a reference file. It reads more like a product onboarding page than a lean skill.
Suggestions
Move the bulk endpoint reference (posts/comments/voting/submolts/moderation/profile sections) into a separate reference file (e.g. references/api.md) and keep SKILL.md as a lean overview with registration, the onboarding workflow, and links — this addresses both conciseness and progressive disclosure.
Fix the contradictory onboarding steps in "Set Up Your Stepbot identity": step 3 instructs posting a self-introduction while step 4 asks the user whether to post one; merge these and reconcile the community name ("stepbot-temple" vs "stepbot_temple").
Delete or drastically trim the padding sections — "Why This Matters", "Everything You Can Do", "Ideas to try", "Your Human Can Ask Anytime", and the ~50-line generic Safety block that restates existing agent safety policy — and fold post-registration validation (checking claim status, handling 429 `retry_after_minutes`) into the workflow as explicit checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Alongside the API reference there are several padded sections Claude does not need: "Why This Matters" with the group-chat-friend analogy, the redundant "Everything You Can Do" recap table, "Ideas to try", "Your Human Can Ask Anytime", and a ~50-line generic "Safety" block that restates system-prompt policies the agent already has. Not 3 because these are multiple, substantial unnecessary sections rather than a few tightenable spots; not 1 because the core API content itself is dense and instructional rather than explaining concepts Claude already knows. | 2 / 5 |
Actionability | Nearly every operation ships a complete, copy-paste-ready curl command with headers and a JSON body — registration, posting, commenting, voting, submolt creation and moderation, following, semantic search, and profile updates — plus concrete response examples (e.g., the register response with `api_key`/`claim_url`, the search response with `similarity` fields) and parameter limits ("1 post per 30 minutes", "Max size: 500 KB"). The commands cover the common cases fully, matching the anchor-5 example. | 5 / 5 |
Workflow Clarity | The main flows (register → save key → send claim_url → check status; heartbeat setup steps 1-3) are sequenced, but the "Set Up Your Stepbot identity" section is contradictory — step 3 says to upvote the manifesto and "post a self-introduction in this submolt" while step 4 then asks whether to post one — and uses inconsistent naming ("stepbot-temple" vs "stepbot_temple"). Validation checkpoints are largely implicit (claim-status checking is documented as an endpoint, not wired into the flow), though the 429 `retry_after_minutes` handling is one real feedback loop. Not 2 because sequences are present and mostly defined; not 4 because of the contradictory steps and missing checkpoints after registration. | 3 / 5 |
Progressive Disclosure | The body has clear section headers and points to HEARTBEAT.md/MESSAGING.md, but those references are remote URLs rather than bundle files, and a ~500-line full API reference (every endpoint for posts, comments, votes, submolts, moderation, profiles) is inlined in SKILL.md — exactly the content that belongs in a separate reference file per the anchor-3 example. Not 2 because the content is well-sectioned and navigable rather than a structureless wall; not 4 because the bulk endpoint reference should clearly live outside the overview file and the only pointers are off-site URLs ("Re-fetch these files anytime to see new features") rather than a local bundle. | 3 / 5 |
Total | 13 / 20 Passed |