CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tweet-ideas

Generate tweet ideas from trends and project updates

56

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./src/skills/bundled/tweet-ideas/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%Weight 40%Scale 1-5

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

A lean, well-organized instruction-only skill with copy-paste commands and concrete examples, held back by an implicit generation workflow and no validation: no character-count limit enforcement is specified for the tweet itself, trend sourcing is hand-waved, and the destructive '/tweets clear' has no confirmation step. Spelling out the generation sequence and a safety check for clear would lift it substantially.

Suggestions

Add an explicit generation workflow: 1. load saved style (or ask if unset), 2. gather trends or read CHANGELOG/README/package.json, 3. draft 3-5 tweets in style, 4. verify each is within the character limit, 5. present with IDs and offer '/tweets save <id>'.

Specify how trend data is actually obtained (which feeds/sources or search tools) and what to do when no data is available (e.g., ask the user for a topic).

Add a confirmation or validation checkpoint before '/tweets clear' discards saved drafts, and state the tweet character limit in the Output section.

DimensionReasoningScore

Conciseness

Every section earns its tokens: a terse command table, copy-paste examples, brief mode descriptions, and a compact output spec, with no explanation of concepts Claude already knows. This matches anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place'); it is not 4 because there is no identifiable over-explanation to trim.

5 / 5

Actionability

Concrete copy-paste slash commands with arguments ('/tweets generate "bitcoin etf"', '/tweets changelog /path/to/CHANGELOG.md') plus concrete style strings cover the common cases, matching anchor 4 ('Mostly executable guidance; concrete commands with minor gaps'). It falls short of 5 because the core generation step is underspecified: 'Pulls from crypto news feeds, market data, social signals' names no actual sources, tools, or fallback when no trend data is available, so execution of the central command is left to inference.

4 / 5

Workflow Clarity

Modes and output are described, but the agent's actual sequence (load saved style, gather source data, draft, verify character count, present with IDs for saving) is implicit rather than listed, and there are no validation checkpoints. Additionally, '/tweets clear' destructively discards all saved drafts with no confirmation or safety step, and per the judging guidelines a destructive/batch operation without validation caps workflow clarity at 3. It is above 2 because the mode descriptions and command semantics do convey a rough sequence.

3 / 5

Progressive Disclosure

The body is a single well-organized file (~70 lines) with clear sections (Commands, Examples, How It Works, Output) and no nested or buried references, matching anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps'). It does not reach 5 because the under-50-lines exception does not apply and everything is inline with no signaled extension points (e.g., a styles/references file) if the skill grows.

4 / 5

Total

16

/

20

Passed

Description

53%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description states a clear, third-person 'what' with a distinct niche, but it is a single-action summary: no 'Use when' trigger guidance and a thin set of natural keywords (no Twitter/X/social media/announcement synonyms). Adding an explicit trigger clause and natural trigger phrases would move it from adequate to strong.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user wants tweets, Twitter/X posts, or launch announcements about trending topics or project updates.'

Include natural synonyms users would actually say: Twitter, X, social media post, thread, announcement, changelog.

Enumerate the concrete capabilities (e.g., generate from trends, announce changelog entries or features, write launch threads) instead of summarizing them as one 'generate' action.

DimensionReasoningScore

Specificity

"Generate tweet ideas from trends and project updates" names the domain (tweet ideas) and one concrete action with two input sources, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' ("Processes PDF files and extracts content"). It is below 4 because it lists only a single action ('generate') rather than several distinct capabilities, and above 2 because it is more concrete than the minimal/generic 'Processes PDF files' level.

3 / 5

Completeness

The 'what' is clear (generate tweet ideas from trends and project updates), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It fits anchor 3 ('Has a clear what but when is missing or only weakly implied') and does not reach 4, which requires both what and when.

3 / 5

Trigger Term Quality

The terms 'tweet', 'tweet ideas', 'trends', and 'project updates' are relevant and natural, but common variations a user would say are missing: 'Twitter', 'X', 'social media post', 'announcement', 'thread', 'changelog'. This matches 'Some relevant keywords but missing common variations or synonyms' rather than 4's 'Good keyword coverage; a few natural terms missing', since whole synonym families are absent, not just a few terms.

3 / 5

Distinctiveness Conflict Risk

Tweet generation from trends/project updates is a clear niche unlikely to trigger the wrong skill, matching anchor 4 ('Mostly distinct; minor overlap risk with closely related skills', e.g., a generic social-media or announcement-writing skill). It does not reach 5 because the anchor-5 example pairs the niche with explicit distinct trigger phrases, which this description lacks.

4 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

alsk1992/CloddsBot

Path

src/skills/bundled/tweet-ideas/SKILL.md

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.