CtrlK
BlogDocsLog inGet started
Tessl Logo

typefully

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

Quality

71%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./config/claude/skills/typefully/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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').

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
freekmurze/dotfiles
Reviewed

Table of Contents

Is this your skill?

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.