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" — and proactively whenever writing or editing content under docs/src/content/docs/, since that's this repo's default docs style.

79

Quality

100%

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

100%

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 instruction skill: concise numbered workflows with a network-failure fallback, concrete commands and file paths, and clean progressive disclosure that externalizes the bulk of the rules to a fetched source. It assumes Claude's competence and adds only repo-specific knowledge.

DimensionReasoningScore

Conciseness

The body is information-dense and assumes Claude's competence — it never explains concepts Claude already knows (e.g. what docs are) and every line is repo-specific, hard-won rule content rather than filler, matching the 'lean and efficient' anchor.

3 / 3

Actionability

Provides concrete, executable specifics — exact fetch URL and WebFetch invocation, 'pnpm --filter cva build' / 'pnpm --filter class-variance-authority build' commands, the two cva import/call forms, and precise file paths — making the guidance copy-paste ready.

3 / 3

Workflow Clarity

How It Works and Usage give clearly numbered, sequenced steps with an explicit error-recovery branch (fetch fails → fall back to house style); although there is no formal validation checkpoint, the reviewing task is non-destructive so the destructive-operation cap does not apply.

3 / 3

Progressive Disclosure

The SKILL.md is an organized overview that delegates the detailed upstream ruleset to a fetched URL and keeps only one-level-deep, clearly signaled references (#cva-house-style, /AGENTS.md, git history); no bundle files exist and references are not nested.

3 / 3

Total

12

/

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, specific description that states concrete actions, an explicit 'Use when...' trigger clause with natural quoted phrases, and a distinct repo-scoped niche. It uses third-person imperative voice and avoids vague fluff.

DimensionReasoningScore

Specificity

Names concrete actions ('Review or write docs/prose') tied to a concrete compliance standard ('Writing Guidelines compliance'), matching the 'lists multiple specific concrete actions' anchor rather than the vaguer anchor 2.

3 / 3

Completeness

Explicitly answers both what ('Review or write docs/prose for Writing Guidelines compliance') and when (a 'Use when asked to...' clause with quoted triggers and a proactive trigger), so it is not capped at 2 for a missing trigger clause.

3 / 3

Trigger Term Quality

Quotes natural phrases users would say verbatim ('review my docs', 'check writing style', 'audit prose', 'review docs voice and tone', 'check this page against the writing handbook') plus a proactive trigger, giving strong coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

It targets a clear niche (this repo's Writing Guidelines compliance for docs/src/content/docs/) with distinct, niche-specific triggers, making it unlikely to fire for an unrelated skill.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 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.