CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plain-writing

Makes prose plain and easy to read, with common words, whole sentences, no dashes, no made-up terms and no comparisons. Use it when you write or revise a document, report, summary, README, email, slide, Notion page, commit message or PR description, or when someone asks you to simplify, reword, tighten or clean up text. It also runs for the command `/plain-writing deslopify`, which rewrites an agent reply. Apply it to the words around code and never to the code.

Quality

92%

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.

A well-crafted instruction-only skill: concrete Avoid/Prefer examples make every rule immediately actionable, the single task is unambiguous, and the organization is clean. The only trimmable fat is mild overlap between a few rules, and the length suggests a couple of sections could be split into reference files.

DimensionReasoningScore

Conciseness

The body is efficient: every rule is stated once and immediately demonstrated with an Avoid/Prefer pair, with no explanation of concepts Claude already knows, matching the 'efficient; minor instances that could be trimmed' anchor. Not 5 because a few rules overlap (e.g., 'Say exactly what happens' vs 'Cut words that add force and no facts') and the ~165-line rule set could be slightly consolidated.

4 / 5

Actionability

Every one of the roughly 25 rules pairs an 'Avoid' example with a 'Prefer' rewrite, which is copy-paste-equivalent concrete guidance for a writing skill, and the deslopify section specifies the audience, ordering and exact output ('return the rewrite with nothing around it'). This matches the fully executable, common-cases-covered anchor.

5 / 5

Workflow Clarity

This is a single-task skill with no multi-step pipeline, and the single action is unambiguous: apply the listed rules when writing or revising, and for deslopify, rewrite the reply with the conclusion first. Per the rubric's simple-skill note, an unambiguous single action scores 5; there are no destructive or batch operations that would impose a validation cap.

5 / 5

Progressive Disclosure

Sections (Words, Sentences, Paragraphs and chat, Punctuation and layout, Patterns to leave out, deslopify) are clearly headed and the content is uniformly core guidance, matching 'good structure; most content appropriately placed'. Not 5 because at ~165 lines with no bundle files, self-contained sections such as the deslopify command or the word lists could arguably live in one-level-deep reference files.

4 / 5

Total

18

/

20

Passed

Description

91%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-plus-when structure, rich natural trigger synonyms, a named slash command, and a clear code-vs-prose boundary. Its only weaknesses are the single-transformation core action, one incidental second-person phrase, and minor trigger overlap with commit-message and document skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions and constraints ('Makes prose plain and easy to read, with common words, whole sentences, no dashes, no made-up terms and no comparisons' plus 'rewrites an agent reply'), which matches the 'several specific actions; minor gaps' anchor rather than the fully comprehensive anchor. It is primarily third person ('Makes prose', 'It also runs'), but the trigger clause 'when you write or revise' introduces second person, so no voice penalty beyond keeping it below the top anchor is warranted.

4 / 5

Completeness

It explicitly answers both questions: what ('Makes prose plain and easy to read, with common words, whole sentences, no dashes, no made-up terms and no comparisons') and when ('Use it when you write or revise a document... or when someone asks you to simplify, reword, tighten or clean up text'), plus a command trigger and a scope boundary, matching the anchor-5 example. A 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger coverage is comprehensive: users would plausibly say 'simplify', 'reword', 'tighten' or 'clean up text', and the document-type list (document, report, summary, README, email, slide, Notion page, commit message, PR description) spans the realistic range, matching the comprehensive-synonyms anchor. Not below 4 because the synonyms are exactly the phrases a user would say, not jargon.

5 / 5

Distinctiveness Conflict Risk

The niche (plain prose style, never code) is clear and the deslopify command is distinctive, but triggers like 'commit message or PR description' and 'write... a document' overlap with dedicated commit-message or document-formatting skills, matching 'mostly distinct; minor overlap risk'. Not 5 because of that overlap; not 3 because the style-editing focus and code boundary keep it well separated from generic skills.

4 / 5

Total

18

/

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

Agenta-AI/agenta

Path

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