Content
88%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 excellent instruction-only skill body: lean, entirely novel information, executable setup commands, and a workflow with explicit confirmation gates before anything is published. The remaining improvements are an example create_post request and potentially splitting the platform-rules table into a reference file.
Suggestions
Add a copy-paste-ready example create_post request (e.g., a minimal JSON body scheduling one post with mediaFileIds and postTypeOverrides) so actionability reaches fully-executable coverage.
Consider moving the platform rules and character-limit table into a references/ file (e.g., references/platform-rules.md) to slim SKILL.md toward an overview-plus-pointer structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section delivers facts Claude cannot know (platform character limits, "Instagram defaults to feed_photo", "Facebook cannot mix images and video", the 403 APPROVAL_REQUIRED semantics) with no padding and no explanation of known concepts. It does not fit the anchor 4 example since there is no over-explanation left to trim. | 5 / 5 |
Actionability | Setup gives copy-paste commands ("claude mcp add --transport http bulkpublish https://mcp.bulkpublish.com/mcp") and the create_post block is a complete typed parameter spec. It falls short of a 5 because there is no example request payload (e.g., a sample JSON body for create_post) covering the common case. | 4 / 5 |
Workflow Clarity | The 5-step workflow includes explicit validation checkpoints — "Do this first; never guess a channel id", "Check the platform rules below... before composing", and "Confirm the exact text, target accounts, and time with the user before publishing" — plus error recovery via retry_post and get_channel_health, so the batch-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The single-file body is cleanly sectioned (Setup, Workflow, create_post essentials, Platform rules, Approvals, Analytics, Other tools, Rules) with no nested references. It stays at 4 because at ~97 lines the platform-rules and parameter detail could arguably move to a reference file, and the under-50-line simple-skill exception does not apply. | 4 / 5 |
Total | 18 / 20 Passed |