CtrlK
BlogDocsLog inGet started
Tessl Logo

baoyu-format-markdown

Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layout. Outputs to {filename}-formatted.md.

70

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with concrete commands and a well-sequenced workflow, but loses points for duplicated box-drawing tables and a destructive in-place branch lacking backup/verification. Progressive disclosure is handled well with real, clearly-signaled script references.

Suggestions

Remove the redundant box-drawing tables for EXTEND.md paths and the result/action mapping since the same information appears in the bash snippets; keep one representation.

Add a backup or verification step for the 'Typography fixes only' option, which modifies the original file in-place without a safety copy.

Add a brief post-script verification (check exit code / confirm output file exists) in Step 7-8 so failures are caught before reporting completion.

DimensionReasoningScore

Conciseness

The body is mostly efficient and actionable, but includes redundancy: the EXTEND.md paths and result/action mappings are rendered twice as both bash snippets and box-drawing tables saying the same thing, and the before/after example adds length that could be trimmed.

2 / 3

Actionability

Provides fully executable commands (e.g. 'npx -y bun ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]'), a concrete options table, copy-paste backup bash with timestamps, and clear file-naming examples.

3 / 3

Workflow Clarity

An explicit 8-step sequence with a backup-before-overwrite checkpoint exists, but the 'Typography fixes only' branch modifies the original file in-place (destructive) with no backup or post-run verification, capping workflow clarity at 2 per the destructive-operations guideline.

2 / 3

Progressive Disclosure

Real script bundle files (main.ts, quotes.ts, autocorrect.ts) are referenced one level deep via a clear purpose table, EXTEND.md configuration is documented with explicit paths, and there is no nested reference chaining.

3 / 3

Total

10

/

12

Passed

Description

100%

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, concise description that clearly states capabilities, gives natural trigger phrases, and specifies the output. It cleanly answers what, when, and how results are delivered.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'frontmatter, titles, summaries, headings, bold, lists, and code blocks', matching the score-3 anchor of enumerating specific concrete actions.

3 / 3

Completeness

Explicitly answers both what it does (formats text/markdown with the listed elements) and when to use it via the 'Use when...' clause, including the output target.

3 / 3

Trigger Term Quality

Provides natural phrases users would say — 'format markdown', 'beautify article', 'add formatting', or 'improve article layout' — giving good coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (markdown beautification/formatting) with distinct triggers and a specific output convention, making overlap with unrelated skills unlikely.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.