CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-guidelines

Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes. Use when writing or editing documentation, interface copy, or any text a human will read. Says "write the README", "improve this copy", "draft the docs", "word this error".

Quality

93%

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

100%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 exemplary instruction-only skill body: lean, concrete, and immediately actionable, with specific word lists, a before/after example, and a defined output format. It fully meets the simple-skill exceptions for workflow clarity and progressive disclosure.

DimensionReasoningScore

Conciseness

The ~43-line body is lean: every rule is 1-3 lines, filler is handled by naming deletable words ('just', 'simply', 'basically', 'in order to') rather than explaining why, and no concept Claude already knows is taught. Matches 'every token earns its place'; there is no over-explanation to trim for anchor 4.

5 / 5

Actionability

Instruction-only skill with concrete, executable guidance: a specific deletable-word list, a before/after error-message rewrite ('Config not found at ./app.config.ts. Create it or pass --config <path>.' beats 'Error: config missing'), and a specific AI-slop tell list. Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

Simple single-purpose skill under 50 lines: the single action (apply the rules when writing or editing prose) is unambiguous, and the Output section specifies the deliverable ('show the tightened version and, on request, a one-line note per change'). No destructive or batch operations, so the validation cap does not apply.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external bundle files, so well-organized sections alone satisfy the rubric: four clear sections (Rules, Error messages and UI copy, AI-slop tells, Output) and the one cross-skill reference (domain-modeling's CONTEXT.md) is clearly signaled.

5 / 5

Total

20

/

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 description that clearly states what the skill does and gives explicit, natural trigger phrases including verbatim user quotes. The main weaknesses are the single abstract action verb and a few missing common synonyms, plus slightly unbounded scope that raises minor overlap risk.

Suggestions

Name the concrete actions performed (e.g., 'Tightens prose, strips filler and AI-slop tells, rewrites error messages with next steps') instead of the single abstract verb 'apply clear-writing standards'.

Add natural trigger synonyms users actually say, such as 'proofread', 'polish', 'rewrite', or 'make this clearer'.

Sharpen the boundary by stating the skill covers wording and style only, not document formats or content structure, to reduce overlap with docx/pptx and commit-generation skills.

DimensionReasoningScore

Specificity

Enumerates six concrete prose targets ('READMEs, docs, UI copy, error messages, commit and PR text, release notes'), giving near-comprehensive coverage, but the single action verb 'apply clear-writing standards' is abstract rather than naming concrete operations like 'tighten' or 'strip filler'. Fits anchor 4 (several specifics, minor gaps) better than 3, whose actions are only 1-2; not 5 because the action list is one generic verb.

4 / 5

Completeness

Explicitly answers both: the 'what' ('Apply clear-writing standards to any prose the agent produces' with enumerated artifact types) and the 'when' ('Use when writing or editing documentation... Says "write the README"...') with concrete trigger phrases. Matches the anchor 5 example structure exactly; not 4 because the 'when' clause is fully explicit with quoted triggers.

5 / 5

Trigger Term Quality

Includes genuinely user-spoken quoted triggers ('write the README', 'improve this copy', 'draft the docs', 'word this error') plus 'writing or editing documentation'. A few natural synonyms users would say are missing ('proofread', 'polish', 'rewrite this', 'make it clearer'), so anchor 4 rather than 5, but well above anchor 3's missing-variations level.

4 / 5

Distinctiveness Conflict Risk

The style-and-wording niche is mostly distinct from format-manipulation skills, but the scope 'any text a human will read' is broad and creates minor overlap risk with closely related skills (commit-message generators, docs-writing, docx/pptx skills). Fits anchor 4's 'mostly distinct; minor overlap risk'; not 5 because the unbounded scope prevents a truly clear niche.

4 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

rohitg00/pro-workflow

Path

skills/writing-guidelines/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.