CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

baoyu-danger-x-to-markdown

Converts X (Twitter) tweets and articles to markdown with YAML front matter. Uses reverse-engineered API requiring user consent. Use when user mentions "X to markdown", "tweet to markdown", "save tweet", or provides x.com/twitter.com URLs for conversion.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-engineered script-driven skill: concrete commands and file paths make it immediately executable, workflows are clearly sequenced with conditional branches, and detail is properly deferred to the references and scripts bundles. The only trimmable content is the generic user-input-tool section, and error-recovery guidance is absent.

DimensionReasoningScore

Conciseness

The body is efficient — terse tables, numbered steps, and no explanations of concepts Claude already knows — but the "User Input Tools" section spends several lines on generic runtime input-tool selection/fallback rules that could be trimmed to one line, matching anchor 4's "minor instances of over-explanation".

4 / 5

Actionability

Fully executable guidance: copy-paste ready commands with a defined ${BUN_X} resolution rule, an options table, exact consent-file paths per OS, the consent JSON template to write, supported URL formats, and a concrete output example — specific examples cover the common cases.

5 / 5

Workflow Clarity

Multi-step flows (consent, preferences, media download) are clearly sequenced with decision branches (accept/decline, check-for-media then ask then rerun with --download-media), but there are minor validation gaps — no error-recovery guidance for script, auth, or API failures — so it fits anchor 4 rather than 5.

4 / 5

Progressive Disclosure

A clear sectioned overview with a well-signaled, one-level-deep reference (references/config/first-time-setup.md, verified to exist and contain the setup questions) and implementation appropriately split into the scripts/ bundle; everything kept inline (consent text, preference keys) is needed for the core flow.

5 / 5

Total

18

/

20

Passed

Description

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

A strong description in third-person voice that clearly states what the skill does and when to use it, with concrete trigger phrases and URL patterns. The only weakness is capability breadth — it names the core conversion actions but omits secondary capabilities like media download and thread support.

DimensionReasoningScore

Specificity

"Converts X (Twitter) tweets and articles to markdown with YAML front matter" names the domain and 1-2 concrete actions (tweet conversion, article conversion) with an output-format detail, but coverage is not comprehensive — media download, thread handling, and JSON output are not mentioned, so it sits at anchor 3 rather than 4's "several specific actions".

3 / 5

Completeness

Explicitly answers both questions: the "what" ("Converts X (Twitter) tweets and articles to markdown with YAML front matter") and the "when" with concrete trigger phrases ("Use when user mentions 'X to markdown', 'tweet to markdown', 'save tweet', or provides x.com/twitter.com URLs"), matching the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

Includes natural phrases users would actually say — "X to markdown", "tweet to markdown", "save tweet", and x.com/twitter.com URL patterns — but misses common variations like "thread", "archive tweet", or extension mentions, matching anchor 4's "good keyword coverage; a few natural terms missing".

4 / 5

Distinctiveness Conflict Risk

A clear niche (X/Twitter content to markdown) with platform-specific triggers (x.com/twitter.com URLs, tweet-specific phrases) that no generic markdown-converter skill would match, giving minimal conflict risk.

5 / 5

Total

17

/

20

Passed

Validation

68%

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

Validation — 11 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

11

/

16

Passed

Repository

JimLiu/baoyu-skills

Path

skills/baoyu-danger-x-to-markdown/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.