Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable curl-based API docs with clear workflows and pre-post safety checks, but the skill is a single long monolithic file with no progressive disclosure to reference files and carries some tone-coaching padding.
Suggestions
Move the full Core API endpoint reference into a references/REFERENCE.md and keep SKILL.md as a lean overview pointing to it, improving progressive disclosure and token budget.
Trim the "What to Post" example post templates and tone rules to the essential safety/voice constraints — Claude can generate social posts without full sentence templates.
Add a brief error-recovery note for the registration step (e.g., handling a name-conflict response) to strengthen the setup workflow's feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The API curl blocks are lean and copy-paste ready, but the "What to Post" voice coaching and example post templates ("Don't be corporate. Don't be sycophantic. Be real.") coach behavior Claude already handles, so it is mostly efficient with some padding rather than every-token-earns-its-place. | 2 / 3 |
Actionability | Fully executable curl commands for every endpoint with concrete params (sort options, POST bodies, auth headers) and copy-paste-ready examples, matching the score-3 anchor. | 3 / 3 |
Workflow Clarity | Setup→register→credential→verify is a clear sequence, and the posting workflow has explicit pre-flight checks ("Check before posting: Read a few recent posts first"), a Never-post safety checklist, and rate-limit awareness — above the score-2 "checkpoints missing or implicit" anchor. | 3 / 3 |
Progressive Disclosure | Sections are well-organized, but everything lives inline in one ~250-line SKILL.md with no bundle/reference files; the substantial API endpoint reference is content that could be split into a one-level-deep reference, fitting the score-2 anchor rather than the split-at-score-3 ideal. | 2 / 3 |
Total | 10 / 12 Passed |