CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

baoyu-format-markdown

技术写作员与内容创作者在处理纯文本或 Markdown 稿件时,若需优化文章结构、添加 frontmatter 或自动修正中英文排版间距,使用此技能可一键生成专业美观的 {filename}-formatted.md 文件,让文档排版更完美。

61

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/content-creation-publisher/baoyu-format-markdown/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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, largely actionable workflow document with concrete commands, option tables, and a good before/after example. Its main weaknesses are token inefficiency (Markdown-detection table and redundant ASCII box tables) and the absence of validation/backup on the in-place file-modification path, which caps workflow clarity.

Suggestions

Delete the content-type detection table and replace with one line like 'If the file has frontmatter/headings/list/code syntax, treat as Markdown; otherwise plain text' — Claude already knows Markdown syntax.

Add a backup and post-run verification step for the 'Typography fixes only' path (it modifies the original in place), e.g. copy to a .bak first and confirm the script exited 0 before reporting success.

Replace the box-drawing ASCII tables with plain markdown tables or bullets, and consolidate the EXTEND.md path/action information into the single Preferences section — it currently appears three times.

DimensionReasoningScore

Conciseness

The body is mostly efficient workflow instruction, but contains unnecessary material: a 7-row table explaining how to detect Markdown (“Has `#`, `##`, `###` headings”, “Has `**bold**`, `*italic**`”) that Claude already knows, box-drawing ASCII tables restating information a simple list would carry, and EXTEND.md paths shown twice (bash snippet plus box table) plus a third pointer in the “Extension Support” section. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the clearly padded level below.

3 / 5

Actionability

Mostly executable guidance: the exact command “npx -y bun ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]” with a full option table, four copy-paste examples, a concrete backup snippet, and a before/after formatting example. Minor gaps keep it from a 5: the EXTEND.md format is never defined (only vague “Default formatting options | Summary length preferences”), so that part is not executable, and “{filename}” placeholders depend on inference.

4 / 5

Workflow Clarity

Steps 1–8 are clearly sequenced with explicit branching from the Step 1.5 user choice, but validation is missing where it matters: the “Typography fixes only” path modifies the original file in place with no backup or verification, and Step 7→8 has no check that the script succeeded (no error handling or feedback loop). Per the rubric's cap, a workflow with in-place file modification and no validation checkpoints cannot score above 3; it is well above the 'rough sequence with many gaps' level, so 3 rather than 2.

3 / 5

Progressive Disclosure

Structure is good: the script logic is properly split into scripts/ (main.ts, quotes.ts, autocorrect.ts — all real files, clearly surfaced via the script table), the workflow stays in SKILL.md where it belongs, and sections are well-organized. Minor gaps: the ~290-line body inlines the option table and formatting example that could live in a reference file or `--help`, and EXTEND.md settings are pointed to but never enumerated — 'good structure, minor organization gaps'.

4 / 5

Total

14

/

20

Passed

Description

83%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 (structure optimization, frontmatter, CJK typography fixes, formatted output file) and when to use it, with natural trigger language for a technical-writing audience. It could add a few more trigger synonyms (format, .md, 美化/排版) and mention quote replacement to round out coverage.

Suggestions

Add common trigger synonyms such as “格式化” (format) or “.md 文件” so users phrasing the need differently still match.

Mention the quote replacement and CJK emphasis-fix capabilities to make the 'what' coverage comprehensive.

Trim the closing puffery “让文档排版更完美” — it adds no actionable information.

DimensionReasoningScore

Specificity

The description lists several concrete actions — “优化文章结构” (optimize article structure), “添加 frontmatter” (add frontmatter), “自动修正中英文排版间距” (auto-fix CJK/English spacing), and generating a “{filename}-formatted.md” output — matching the anchor for several specific actions with minor gaps (quote replacement, title generation, and emphasis fixes are not mentioned).

4 / 5

Completeness

It explicitly answers both questions: what (“生成专业美观的 {filename}-formatted.md 文件”, optimize structure, add frontmatter, fix spacing) and when (“在处理纯文本或 Markdown 稿件时,若需…” — an explicit 'when processing plain text or Markdown manuscripts and needing…' trigger clause with concrete trigger conditions). This matches the anchor for clearly and explicitly answering both what and when with concrete trigger phrases, and avoids the missing-'Use when' cap.

5 / 5

Trigger Term Quality

Natural terms users would say are present: “纯文本” (plain text), “Markdown”, “frontmatter”, “排版” (typography), and “中英文排版间距” (CJK/English spacing), which is good keyword coverage. A few natural variations are missing (e.g., “格式化” / “format”, “美化”, or the .md extension as a trigger), so it falls just short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The CJK/English typography spacing and frontmatter focus carves a fairly distinct niche that generic markdown-formatting skills don't cover, so conflict risk is low. However, “优化文章结构” and “Markdown” formatting broadly could overlap with other document-formatting skills, giving minor overlap risk with closely related skills.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

anbeime/skill

Path

skills/content-creation-publisher/baoyu-format-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.