CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-guidelines

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

64

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/writing-guidelines/SKILL.md

The canonical home for this skill is writing-guidelines in vercel-labs/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

62%

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

The body lays out a clear, simple review workflow but is held back by duplicated step lists and by deferring all actual rule content to a fetched remote URL. Tightening the redundancy and embedding or locally bundling the core rules would materially raise quality.

Suggestions

Collapse the near-identical 'How It Works' and 'Usage' step lists into a single workflow section to remove duplication.

Add a concrete example invocation and a sample `file:line` finding so the output format is unambiguous without relying on the fetched content.

Bundle the guidelines as a local reference file (or inline the canonical rules) so the skill is self-contained and resilient to the remote URL being unavailable.

DimensionReasoningScore

Conciseness

The 'How It Works' and 'Usage' sections repeat the same four-step workflow almost verbatim, and the opening line restates the description, so it is mostly efficient but includes avoidable duplication.

2 / 3

Actionability

It supplies a concrete URL, names WebFetch, and specifies the `file:line` output format, but defers all actual rules to the fetched remote content with no example invocation or sample output, leaving the guidance incomplete.

2 / 3

Workflow Clarity

For a simple read-only review task, the four-step sequence (fetch, read, check, output) is clear and unambiguous; no destructive or batch operation is involved so the validation cap does not apply.

3 / 3

Progressive Disclosure

Sections are well organized, but the substantive rules content is offloaded entirely to a remote URL rather than held locally or in bundle files, introducing a one-level reference that is also a single point of failure.

2 / 3

Total

9

/

12

Passed

Description

90%

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: it states the skill's purpose concisely, provides explicit and natural trigger phrases, and carves out a distinct niche. The only gap is that it names a single action rather than enumerating multiple concrete capabilities.

DimensionReasoningScore

Specificity

Names the domain ('docs/prose', 'Writing Guidelines compliance') and a single concrete action ('Review') in third person, but does not enumerate multiple distinct actions, matching anchor 2 rather than 3.

2 / 3

Completeness

Explicitly answers both what ('Review docs/prose for Writing Guidelines compliance') and when ('Use when asked to...'), with explicit trigger guidance rather than implied timing.

3 / 3

Trigger Term Quality

Quotes five natural user phrases ('review my docs', 'check writing style', 'audit prose', 'review docs voice and tone', 'check this page against the writing handbook'), giving good coverage of terms a user would actually say.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (writing-style/handbook compliance review) with distinct triggers, making it unlikely to fire for unrelated skills.

3 / 3

Total

11

/

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
zhukunpenglinyutong/desktop-cc-gui
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.