x-article-publisher

Publish Markdown articles to X (Twitter) Articles editor with proper formatting. Use when user wants to publish a Markdown file/URL to X Articles, or mentions "publish to X", "post article to Twitter", "X article", or wants help with X Premium article publishing. Handles cover image upload and converts Markdown to rich text automatically.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github/SKILL.md

Quality

Content

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

Highly actionable with concrete executable commands and a clear workflow, but held back by verbosity and missing validation feedback loops for a destructive publishing operation. Progressive disclosure is moderate, with substantial inline content and a broken external reference.

Suggestions

Add an explicit validation checkpoint and error-recovery loop to the publish workflow (e.g., verify cover upload succeeded before pasting content; re-run on failure) to lift workflow clarity above the destructive-operation cap.

Trim emoji-heavy bilingual explanation and move the auth setup and smart-enhancement (title/cover generation) sections into separate reference files linked from the main body to improve token efficiency and progressive disclosure.

Fix or remove the dangling ../skill-development-guide/technical-lessons.md reference, or replace it with a bundled reference file that actually exists.

Dimension	Reasoning	Score
Conciseness	Mostly task-relevant but padded with emoji-heavy bilingual prose, a cover-image prompt template, and repeated auth detail that could be tightened; some explanation does not earn its tokens.	3 / 5
Actionability	Copy-paste ready commands throughout (publish_article.py --file, auth_manager.py setup/status/validate) plus a concrete parse_markdown JSON output spec, covering common cases.	5 / 5
Workflow Clarity	A clear 9-step one-click workflow plus a manual path exists, but this publishing/batch operation lacks explicit validation checkpoints or an error-recovery feedback loop, which caps the score per the rubric.	3 / 5
Progressive Disclosure	Well-sectioned with headers but content is largely inline (auth, smart enhancements, technical details) that could live in separate files, and the lone out-of-bundle reference (../skill-development-guide/technical-lessons.md) is not present in the bundle.	3 / 5
	Total	14 / 20 Passed

Description

95%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, well-targeted description that clearly states capabilities and triggers with concrete natural phrases. Minor specificity gaps (auth, draft-saving) keep it just below a perfect specificity score.

Dimension	Reasoning	Score
Specificity	Names three concrete actions ("Publish Markdown articles to X", "Handles cover image upload", "converts Markdown to rich text") with minor coverage gaps (no mention of parsing, draft-saving, or auth).	4 / 5
Completeness	Explicitly answers both what (publish Markdown articles, handle cover upload, convert to rich text) and when (concrete "Use when..." trigger phrases).	5 / 5
Trigger Term Quality	Comprehensive natural trigger phrases including synonyms ("publish to X", "post article to Twitter", "X article", "X Premium article publishing", "Markdown file/URL").	5 / 5
Distinctiveness Conflict Risk	Clear niche (X/Twitter Articles publishing) with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 missing, 1 suspicious	Warning

	Total	15 / 16 Passed

Repository: anbeime/skill
Path: skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github/SKILL.md
Commit: 7054767

Reviewed: 2 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.