Create, schedule, and manage social media posts via Typefully. ALWAYS use this skill when asked to draft, schedule, post, or check tweets, posts, threads, or social media content for Twitter/X, LinkedIn, Threads, Bluesky, or Mastodon.
60
71%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./config/claude/skills/typefully/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly communicates what the skill does, when to use it, and includes comprehensive trigger terms covering multiple social media platforms and common user phrasings. The explicit 'ALWAYS use this skill when...' clause with enumerated actions and platforms makes it highly effective for skill selection. The description is concise yet thorough.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create, schedule, and manage social media posts via Typefully.' These are clear, actionable verbs tied to a specific platform. | 3 / 3 |
Completeness | Clearly answers both 'what' (create, schedule, manage social media posts via Typefully) and 'when' (explicitly states 'ALWAYS use this skill when asked to draft, schedule, post, or check tweets, posts, threads, or social media content'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'draft, schedule, post, check, tweets, posts, threads, social media content, Twitter/X, LinkedIn, Threads, Bluesky, Mastodon.' These are highly natural and comprehensive. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive due to the specific tool name 'Typefully' and the enumeration of specific platforms (Twitter/X, LinkedIn, Threads, Bluesky, Mastodon). Unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill excels at actionability with fully executable, copy-paste-ready CLI commands and clear intent-to-action mappings. However, it is severely bloated—information is repeated across multiple sections (Common Actions, Workflow, Commands Reference, Examples, Tips), and the entire content is crammed into a single file with no progressive disclosure. The workflow section covers the happy path but lacks validation checkpoints for destructive operations like publishing.
Suggestions
Split the monolithic file into SKILL.md (overview + workflow + common actions) with references to COMMANDS.md (full reference table), EXAMPLES.md (all examples), and MEDIA.md (media upload details and thread media syntax).
Eliminate redundancy by removing duplicate explanations of multi-platform posting, scratchpad usage, LinkedIn mentions, and default social set behavior—each concept should appear in exactly one authoritative location.
Trim the 'Handling API key not found errors' section to 2-3 lines: tell the user to run setup, wait for confirmation, don't search for keys elsewhere. The current 15+ lines with a DO NOT list over-explains.
Add a validation checkpoint after draft creation in the workflow (e.g., 'Verify draft was created: `drafts:get <draft_id> --use-default`') and before publishing (e.g., 'Review draft content before publishing—this action is irreversible').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~450+ lines. There is significant redundancy: the same information about default social sets, --use-default flags, and multi-platform posting is repeated across multiple sections (Common Actions, Workflow, Publishing to Multiple Platforms, Commands Reference, Examples). The Examples section alone contains 30+ examples that largely duplicate the Commands Reference. Character limits, scratchpad usage, and LinkedIn mentions are each explained in multiple places. The 'Handling API key not found errors' section over-explains what NOT to do. Claude doesn't need to be told not to grep through the user's Trash. | 1 / 3 |
Actionability | Every command is fully executable with exact CLI syntax, flags, and expected outputs. The examples are copy-paste ready with concrete commands like `./scripts/typefully.js drafts:create --text "Hello, world!"` and include return value examples for media uploads. The Common Actions table maps user intents directly to specific commands. | 3 / 3 |
Workflow Clarity | The main workflow for creating posts has a clear sequence (check config → list social sets → create draft → schedule/publish), but it lacks validation checkpoints. There's no step to verify a draft was created successfully before scheduling, no error handling for failed API calls beyond the API key setup case, and the publishing step (which is described as 'irreversible') has no explicit confirmation checkpoint in the workflow itself despite being mentioned elsewhere. | 2 / 3 |
Progressive Disclosure | The content is a monolithic wall of text with no references to external files despite being a complex, multi-feature skill. The Commands Reference, all examples, automation guidelines, LinkedIn mention details, media upload workflows, and thread creation details are all inline. This would benefit enormously from splitting into separate reference files (e.g., COMMANDS.md, EXAMPLES.md, MEDIA.md) with the SKILL.md serving as a concise overview. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (616 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
3974caa
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.