CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

x-article-publisher-skill

Publish articles to X/Twitter

Quality

52%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/x-article-publisher-skill/SKILL.md

The canonical home for this skill is x-article-publisher-skill in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

30%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.

The body is a template skeleton: it is short and sectioned but contains no actual instructions, code, workflow, or bundled references, delegating everything to an external GitHub link. As a skill it would leave Claude with nothing actionable to execute.

Suggestions

Replace the generic Instructions section with executable guidance: X API authentication setup, concrete request examples for creating/publishing articles, and formatting requirements.

Add a sequenced workflow (draft → format → attach media → publish) with an explicit verification step before public posting, since publishing is an outward-facing operation.

Either inline the essential how-to content or bundle it as one-level-deep reference files (e.g. references/api.md) instead of pointing only to the external source repository, and fix the garbled phrasing 'work with publish articles to x/twitter'.

DimensionReasoningScore

Conciseness

The body is ~90 tokens and explains nothing Claude already knows, but the tokens it does spend are redundant template filler: "Publish articles to X/Twitter", "work with publish articles to x/twitter", and "guidance and patterns for publish articles to x/twitter" repeat the same phrase three times. This matches anchor 4 ('efficient; minor instances... that could be trimmed') rather than anchor 5, whose 'every token earns its place' standard the boilerplate repetition fails.

4 / 5

Actionability

The Instructions section states only "This skill provides guidance and patterns for publish articles to x/twitter" — no code, commands, API endpoints, authentication steps, or examples. This is a direct match for anchor 1 ('entirely vague or abstract; no concrete code or commands; only describes rather than instructs'); it cannot be 2 because not even high-level hints toward executable steps are present.

1 / 5

Workflow Clarity

Publishing to X is a multi-step, outward-facing operation (authenticate, draft, attach media, publish), yet the body contains no sequence of steps whatsoever and no validation before posting. This matches anchor 1 ('steps missing or incoherent; no sequence; no validation for risky operations'); anchor 2 would require at least a rough sequence, which is absent.

1 / 5

Progressive Disclosure

Sections are present and well-labeled (Overview, When to Use, Instructions) and no bundle files exist to organize, but the skill's entire substance is delegated to an external URL ("see the [source repository](...)") rather than bundled one-level references, so the actual instructions are neither inline nor discoverable. This fits anchor 3 ('some structure but could be better organized'); it is not 2 since nothing is inlined or buried, and not 4 because the content is not 'appropriately placed' — it is missing.

3 / 5

Total

9

/

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 is concise and names a concrete, distinctive capability, but it is a single bare clause. It answers 'what' adequately while completely omitting 'when', and its trigger vocabulary is thinner than what users would naturally say.

Suggestions

Add an explicit 'when' clause, e.g. "Use when the user asks to publish, post, or draft long-form articles on X/Twitter."

Broaden trigger vocabulary with natural synonyms such as "post", "tweet", "thread", and "X Articles".

Enumerate the concrete capabilities (e.g. drafting, formatting, media attachment, publishing via the X API) to lift specificity beyond a single action.

DimensionReasoningScore

Specificity

"Publish articles to X/Twitter" names the domain (X/Twitter articles) and one concrete action (publish), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is above anchor 2 because 'publish articles' is a concrete action rather than a generic verb like 'Processes PDF files', and below anchor 4 because no further actions (drafting, media upload, threading, scheduling) are listed.

3 / 5

Completeness

The description gives a clear 'what' ("Publish articles to X/Twitter") but contains no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not score 2 because the 'what' is clear rather than vague, and not 4 because the 'when' is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

The terms "publish", "articles", "X", and "Twitter" are relevant and the "X/Twitter" pairing covers both platform names, but the natural phrases users would most often say ("post", "tweet", "thread") are missing. This fits anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"articles" combined with "X/Twitter" carves a clear niche (X's long-form article publishing) with minimal conflict risk against unrelated skills. It falls short of anchor 5 only because the absence of explicit trigger phrases leaves minor overlap risk with a broader social-media posting skill.

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/x-article-publisher-skill/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.