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.

Quality

77%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

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

Quality

Content

55%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is highly actionable with excellent executable examples and clear workflows, but suffers severely from verbosity and lack of progressive disclosure. Information is repeated across Common Actions, Workflow, Commands Reference, Examples, and Tips sections, inflating the token cost significantly. The content would benefit greatly from splitting the exhaustive command reference and examples into separate files, keeping SKILL.md as a concise overview with the workflow and most common patterns.

Suggestions

Deduplicate aggressively: the same commands and concepts (default social set, --use-default, scratchpad, LinkedIn mentions, multi-platform posting) appear in 3-5 different sections. Pick one canonical location for each and remove the rest.

Move the Commands Reference tables and the extensive Examples section into separate files (e.g., COMMANDS.md, EXAMPLES.md) and reference them from SKILL.md to dramatically reduce the main file size.

Consolidate the Tips section into the relevant workflow/command sections rather than repeating information already covered elsewhere in the document.

Remove explanatory text that Claude already knows (e.g., what social media platforms are, what rate limits mean) and trust Claude to infer context from the command syntax.

Dimension	Reasoning	Score
Conciseness	The skill is extremely verbose at ~450+ lines. There is massive redundancy: the same information about default social sets, --use-default flags, and platform options is repeated across multiple sections (Common Actions, Workflow, Commands Reference, Examples, Tips). The Examples section alone contains 30+ examples that largely duplicate the Commands Reference table. Character limits, scratchpad usage, and LinkedIn mentions are each explained in multiple places. Claude doesn't need this level of repetition.	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!"`. The Common Actions table maps user intents directly to specific commands.	3 / 3
Workflow Clarity	The workflow section provides a clear numbered sequence for creating posts, starting with checking config, resolving social sets, creating drafts, and scheduling/publishing. The API key error handling section has explicit validation steps (tell user, stop and wait, do not attempt alternatives). The multi-platform workflow has a clear create-then-update sequence. Publishing confirmation acts as a safety checkpoint for destructive operations.	3 / 3
Progressive Disclosure	The entire skill is a monolithic document with no references to supporting files despite being extremely long. The Commands Reference tables, extensive Examples section, and detailed LinkedIn mentions guide could all be split into separate reference files. No bundle files are provided, and the content that should be in separate files (API reference, examples catalog) is all inline, creating a wall of text.	1 / 3
	Total	8 / 12 Passed

Description

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 an excellent skill description that clearly communicates what the skill does, when to use it, and includes comprehensive trigger terms covering multiple platforms and actions. It follows third-person voice, is concise, and has a clear niche that minimizes conflict risk with other skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions: 'Create, schedule, and manage social media posts.' These are specific, actionable verbs tied to a clear domain (social media via Typefully).	3 / 3
Completeness	Clearly answers both 'what' (create, schedule, manage social media posts via Typefully) and 'when' (explicit 'ALWAYS use this skill when...' clause with detailed trigger scenarios).	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

Validation

81%

Warnings & errors only

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

Repository: freekmurze/dotfiles
Commit: ef5ffa0

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.