CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-guidelines

Review or write docs/prose for Writing Guidelines compliance. Use when asked to "review my docs", "check writing style", "audit prose", "review docs voice and tone", "check this page against the writing handbook", or when writing/editing content under docs/src/content/docs/.

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

86%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 skill body whose house-style rules are specific and non-obvious, with clear conditional fallbacks. Its only real costs are a duplicated workflow description across two sections and the absence of an explicit validation pass over findings before output.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, high-value rules (beta vs. stable import forms, the // => derivation procedure, smartypants handling), but "How It Works" steps 1-4 and the "Reviewing" steps in Usage restate the same fetch-read-apply-output workflow. That duplicated section is a minor trimmable redundancy, matching the "minor instances of over-explanation" anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Guidance is concrete and executable throughout: the exact fetch URL, build commands ("pnpm --filter cva build"), file paths (docs/src/content.config.ts, docs/astro.config.ts), and precise code forms ("cva(base, options)" vs "cva({ base, ...options })"). Specific commands and examples cover the common review and writing cases, matching the fully-executable anchor for an instruction-only skill.

5 / 5

Workflow Clarity

The fetch-read-apply-output sequence is clearly numbered with error-recovery branches ("If the fetch fails, fall back to the cva house style", "If no files are specified, ask the user"), but there is no validation checkpoint on findings before they are reported or applied. This matches "clear sequence with most checkpoints present; minor validation gaps" rather than the explicit validate-fix-retry anchor.

4 / 5

Progressive Disclosure

No bundle files exist, so this scores against the single-file structure: a ~47-line body with well-organized sections (How It Works, Guidelines Source, Usage, cva house style), working internal anchors, and one-level-deep external pointers (AGENTS.md, the guidelines URL). Per the simple-skill guidance, a short skill with no need for external references and clean organization earns the top anchor.

5 / 5

Total

18

/

20

Passed

Description

86%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 with an explicit what-and-when structure and an excellent set of natural trigger phrases. The only weakness is that the capability statement covers just two broad actions (review, write) without enumerating the concrete sub-tasks the skill actually performs.

Suggestions

Enumerate 2-3 more concrete capabilities in the opening sentence (e.g., "audit prose against rules, fix voice/tone and punctuation issues, derive accurate code-example outputs") to lift specificity beyond the two-action statement.

Consider mentioning that it applies both the upstream Vercel ruleset and repo house style, which differentiates it from generic writing-style skills and further reduces conflict risk.

DimensionReasoningScore

Specificity

"Review or write docs/prose for Writing Guidelines compliance" names the domain and exactly two actions (review, write), matching the anchor for 1-2 concrete actions that are not comprehensive. Sub-capabilities like auditing, fixing, or rewriting prose are only implied through trigger phrases rather than stated as capabilities, so it falls short of the several-actions anchors.

3 / 5

Completeness

It explicitly answers what ("Review or write docs/prose for Writing Guidelines compliance") and when ("Use when asked to... or when writing/editing content under docs/src/content/docs/") with concrete trigger phrases. This matches the anchor requiring both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The description quotes multiple natural user phrasings — "review my docs", "check writing style", "audit prose", "review docs voice and tone", "check this page against the writing handbook" — plus the content path "docs/src/content/docs/". Coverage of natural terms, synonyms, and phrasing variations matches the comprehensive-coverage anchor.

5 / 5

Distinctiveness Conflict Risk

The Writing Guidelines compliance niche and repo-specific docs path make it mostly distinct, but generic triggers like "check writing style" and "write docs" carry minor overlap risk with general writing/editing skills. This fits the "mostly distinct; minor overlap risk" anchor rather than the clear-niche anchor.

4 / 5

Total

17

/

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 suspicious

Warning

Total

15

/

16

Passed

Repository
joe-bell/cva
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.