CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

markdown-round-trip

Check that every small Markdown source parses, serializes and parses again to the same document, and that a streamed parse that continues its previous result equals a fresh parse at every chunking, over the plugins of the Markdown test editor. Use before and after changing packages/platejs/src/markdown/lib or another file in its coverage record, when the markdown-round-trip step of pnpm check fails, or when fixing a Markdown or streaming bug a seed or a tester found.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is highly actionable and operationally rigorous: commands, exit codes, triage rules, and feedback loops leave no ambiguity about how to run the gate and respond to failures. Its weaknesses are density and structure — roughly half the file is reference-grade findings and validation history inlined into SKILL.md, which hurts token efficiency and works against progressive disclosure.

Suggestions

Move the "Findings" class catalog and the "What a pass proves" planted-bug history into a one-level-deep reference file (e.g. FINDINGS.md) and keep a short summary with a clearly signaled link, reducing SKILL.md's token footprint.

Tighten the dense prose in "What it checks" — the enumerated token lists and fixed-source explanations could be condensed to the operationally relevant facts, since the script itself enumerates the cases.

Consider moving the coverage-record table and its git re-check procedure into a separate reference so the main body focuses on run, read, and triage workflows.

DimensionReasoningScore

Conciseness

There is no padding or explanation of concepts Claude already knows, but the ~17KB body inlines reference-grade material — the 157-finding catalog by class, the planted-bug "What a pass proves" history with commit hashes, and sync-commit provenance — that could be tightened or moved. Not 4: the trimming opportunity is more than minor; large sections read as a verification report rather than operating instructions.

3 / 5

Actionability

Fully executable, copy-paste-ready commands ("pnpm check:markdown-round-trip", "--inline=3 --part=round-trip", "--case='<identity or part of one>'", "--lower", "--jobs=<n>") with exit-code semantics, timing/case-count expectations, real example finding output, and a concrete three-way triage procedure. These cover the common cases.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced (run the gate → read a failure → triage real bug vs modeling error vs intended change → fix → run --lower) with explicit validation checkpoints (exit 0/1/2 meanings, the GATE_CASES count check, baseline comparison) and feedback loops ("the gate fails until you run pnpm check:markdown-round-trip --lower"; "Never weaken a rule or add a baseline entry to get green"), plus a three-point re-check checklist for the coverage record. As a batch operation it has validation, so the cap at 3 does not apply.

5 / 5

Progressive Disclosure

No bundle files exist, and while the single SKILL.md has well-organized section headers, substantial content that belongs in separate one-level-deep reference files — the Findings class catalog, the planted-bug validation history, and the coverage-record table — is inlined in the monolithic body. Not 4: the inlining is substantial rather than a minor organization gap; not 2: the section structure itself is clear and easy to navigate.

3 / 5

Total

16

/

20

Passed

Description

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

The description is exemplary in specificity and completeness: it states both verification properties concretely and pairs them with an explicit, multi-clause "Use when" trigger set anchored to specific files and a named check step. Its only weakness is trigger phrasing that leans on repo-internal jargon, which slightly narrows the natural terms a user would say.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "parses, serializes and parses again to the same document" and "a streamed parse that continues its previous result equals a fresh parse at every chunking" — comprehensively covering both verification rules the skill performs. Not 4: there is no gap in the actions described for what this check does.

5 / 5

Completeness

Both questions are explicitly answered: the "what" states both verification properties concretely, and the "when" gives concrete trigger phrases ("Use before and after changing packages/platejs/src/markdown/lib… when the markdown-round-trip step of pnpm check fails, or when fixing a Markdown or streaming bug"). This matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Markdown", "streamed parse", "markdown-round-trip step of pnpm check", "streaming bug", and the concrete path "packages/platejs/src/markdown/lib". Not 5: a few natural phrasings a user might say (e.g. "serialization", "round trip" as a standalone phrase) are missing, and terms like "a seed or a tester found" are repo jargon rather than user vocabulary.

4 / 5

Distinctiveness Conflict Risk

A clear niche — this repository's Markdown round-trip and streaming verification gate — with triggers tied to specific paths and a named check step, so it is unlikely to fire for any other skill. Not 4: overlap risk is effectively nil given the path- and check-name-specific triggers.

5 / 5

Total

19

/

20

Passed

Validation

75%

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

Validation — 12 / 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 missing

Warning

Total

12

/

16

Passed

Repository

udecode/plate

Path

.agents/skills/markdown-round-trip/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.