CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plate-docs

Use before any edit under content/docs, including a one-line fix to existing advice, a Chinese twin or an embedded demo, and to write or audit Plate public documentation, page design, examples, installation, MDX and navigation.

Quality

87%

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

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

An unusually disciplined instruction-only skill: concrete commands, two decision tables keyed by change type, explicit validation with a feedback loop, and a well-structured reference bundle. The only real weaknesses are a handful of over-compressed run-on sentences and cross-skill paths (../verify, ../plate-ui, ../shadcn) that do not resolve inside the standalone bundle.

DimensionReasoningScore

Conciseness

The body is rule-dense with essentially no explanation of concepts Claude already knows — every line carries a house rule, ownership decision or command. It sits below anchor 5 because a few passages could be tightened: the run-on obligation-words sentence ("It also keeps obligation words (must, may, never), uncertainty and meaningful scope limits as strong as the source says…") and overlapping bullets in "Cover the feature's actual use" that restate "give each a clear home".

4 / 5

Actionability

Fully executable guidance throughout: copy-paste-ready commands ("pnpm --filter www build:source", "node tooling/scripts/check-plite-docs.mjs", "pnpm --filter www build:registry --check"), exact file paths ("content/docs/meta.json", "components/base/button.mdx"), and two decision tables keyed by changed contract and change type that cover the common edit cases.

5 / 5

Workflow Clarity

A clear sequence (handle request → read page/sibling/source → apply house style → select mechanics → verify) with an explicit validation checklist (the "Verify the changed claims" table), a feedback loop ("Run applicable checks once after the final prose pass. New source changes or a failure can require another pass"), and error-recovery guidance for red CI links at HEAD. This matches the anchor-5 pattern of checklist plus validate→fix→retry.

5 / 5

Progressive Disclosure

The "Select the needed mechanics" table routes each changed contract to one of four clearly signaled, one-level-deep reference files, and all four cited files (lanes.md, mdx.md, api-examples.md, plugin.md) exist in the bundle. It falls below anchor 5 because several other referenced paths — ../verify/SKILL.md, ../plate-ui/SKILL.md and the ../shadcn/apps/v4/content/docs/ corpus — do not resolve within this bundle, leaving navigation gaps.

4 / 5

Total

18

/

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, tightly scoped description that answers both what and when with an unusually explicit trigger clause covering edge cases like one-line fixes and Chinese twins. Its main weakness is compression: one long sentence carries all the scope, and it does not state its boundary against the sibling technical-writing skill.

DimensionReasoningScore

Specificity

The description lists several concrete actions and scopes — "write or audit Plate public documentation, page design, examples, installation, MDX and navigation" plus "a one-line fix to existing advice, a Chinese twin or an embedded demo". It falls short of anchor 5 because everything is packed into one tangled sentence, which obscures the coverage and leaves minor gaps in how each area is served.

4 / 5

Completeness

Both halves are explicit: the when is "Use before any edit under content/docs, including a one-line fix to existing advice, a Chinese twin or an embedded demo" — a concrete trigger that anticipates edge cases — and the what is "to write or audit Plate public documentation, page design, examples, installation, MDX and navigation". The when-clause is already fully explicit and specific, so anchor 4's caveat ("'when' could be more explicit") does not apply.

5 / 5

Trigger Term Quality

Good coverage of natural terms a user would say when they need this skill: "edit under content/docs", "documentation", "examples", "installation", "MDX", "navigation", "audit". A few common variations ("docs page", "guide", "API reference") are missing, keeping it below the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche ("Plate public documentation", edits under content/docs, Chinese twins, embedded demos) with triggers unlikely to fire for unrelated skills. It stays below anchor 5 because the description does not itself draw the boundary against the closely related `pstack:technical-writing` skill that the body delegates general prose to, leaving minor overlap risk on generic documentation requests.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 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

relative_links

Relative link issues: 2 suspicious

Warning

Total

13

/

16

Passed

Repository

udecode/plate

Path

.agents/skills/plate-docs/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.