CtrlK
BlogDocsLog inGet started
Tessl Logo

x-article-publisher

内容创作者在需要将 Markdown 长文发布到 X (Twitter) 时,使用此技能一键将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版,免去手动调整与重复登录烦恼,让长文分发更高效。

64

Quality

77%

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 ./skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, highly actionable body with copy-paste commands and a clearly sequenced publish workflow. Main weaknesses are recurring promotional/emoji padding, an internally contradictory cover-image policy, a documented needs_cover_generation flag that the script never sets, and one dead cross-skill reference.

Suggestions

Strip the marketing phrasing and emoji-decorated step lists (e.g. the 🎉 首次使用 section header and the ✅/💡-prefixed steps), and remove the duplicate publish sequence — the Example output block already restates the workflow steps.

Resolve the cover-image contradiction: Critical Rule 2 forbids automatic covers while the 智能封面图生成 section instructs Claude to generate and insert one; also note that parse_markdown.py hardcodes needs_cover_generation to false, so that documented trigger path never fires — align the doc with the script's actual behavior.

Fix or remove the dead reference to ../skill-development-guide/technical-lessons.md, and consider moving the cover-image prompt template and full JSON output schema into a references/ file to keep SKILL.md a lean overview.

DimensionReasoningScore

Conciseness

Mostly operational content with real commands, but noticeably padded: promotional phrasing ("🎉 首次使用:一次认证,告别重复登录", "完美"), emoji-decorated step lists that add tokens without information, the publish sequence stated twice (once as "脚本会自动" steps and again in the Example output), and an inlined cover-image prompt template. This matches anchor 3 (mostly efficient, some unnecessary explanation, could be tightened) rather than 4, since the fluff is recurring rather than a couple of stray instances.

3 / 5

Actionability

Commands are copy-paste ready and complete: `python publish_article.py --file article.md --title "..."`, full auth_manager subcommands, and a documented JSON output schema with field semantics (title_source, block_index). It falls short of 5 because the documented "needs_cover_generation: true" workflow never triggers (parse_markdown.py hardcodes it to False) and the trailing reference to `../skill-development-guide/technical-lessons.md` is a dead path — concrete guidance with minor factual gaps, matching anchor 4.

4 / 5

Workflow Clarity

The main workflow is clearly sequenced with checkpoints: auth status is auto-checked with an explicit fallback prompt, parse output flags (needs_title_generation) drive the next action, and the draft-only save with manual publish confirmation bounds risk. It does not reach 5 because the cover-image guidance is contradictory — Critical Rule 2 says "NO automatic cover images... never insert first image as cover" while the 智能封面图生成 section instructs Claude to generate and insert a cover — leaving a genuine ambiguity, matching anchor 4 (clear sequence, minor gaps).

4 / 5

Progressive Disclosure

Good structure against the actual bundle: all operational logic lives in the seven scripts (auth_manager.py, publish_article.py, parse_markdown.py, copy_to_clipboard.py, etc.) and the body documents their usage as pointers rather than inlining implementation; sections are clearly headed. Minor gaps keep it at anchor 4 rather than 5: the one external reference (../skill-development-guide/technical-lessons.md) is broken, and content like the cover prompt template and full JSON schema could sit in a references/ file to slim SKILL.md.

4 / 5

Total

15

/

20

Passed

Description

87%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 that explicitly covers what the skill does and when to use it, with concrete capabilities and natural trigger keywords in a distinct niche. Minor deductions for marketing fluff ("一键", "完美") and a slight over-claim of "发布" when the skill actually saves drafts only.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "将 Markdown 自动转换为富文本" (convert Markdown to rich text), "发布至 X Articles" (publish to X Articles), "完美保留排版" (preserve formatting), "免去...重复登录" (persistent auth) — though marketing fluff ("一键", "完美", "让长文分发更高效") slightly pads it and "发布" over-claims since the skill only saves drafts. It fits anchor 4 (several specific actions, minor gaps) better than 3 because coverage goes beyond 1-2 actions, and better than 5 because of the fluff and the draft/publish inaccuracy.

4 / 5

Completeness

Both what and when are explicit: what = "将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版"; when = "在需要将 Markdown 长文发布到 X (Twitter) 时" — an explicit 'when needing to...' trigger clause equivalent to 'Use when'. This matches anchor 5 (clearly answers both with concrete trigger phrases) rather than 4, whose 'when' is only weakly explicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Markdown", "长文" (long article), "发布" (publish), "X (Twitter)", "X Articles" — phrases a user would plausibly say when wanting this skill. A few natural variations are missing (tweet, thread, .md, 推文), so it does not reach anchor 5's comprehensive synonym/extension coverage, but clearly exceeds anchor 3's missing-variation level.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and distinct — Markdown-to-X-Articles rich-text publishing with persistent auth — and the trigger terms ("X Articles", "Markdown 长文", "发布到 X") are unlikely to fire for any other skill. This matches anchor 5 (clear niche, distinct triggers, minimal conflict risk).

5 / 5

Total

18

/

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

relative_links

Relative link issues: 1 missing, 1 suspicious

Warning

Total

15

/

16

Passed

Repository
anbeime/skill
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.