writing-clearly-and-concisely

Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional.

1.02x

Quality

53%

Does it follow best practices?

Impact

94%

1.02x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./tests/ext_conformance/artifacts/agents-mikeastock/skills/writing-clearly-and-concisely/SKILL.md

Evaluation results

98%

Rewrite the Onboarding Guide

Active voice and conciseness

Criteria

Without context

With context

Active voice: IT access

100%

Active voice: 2FA requirement

100%

Active voice: setup script

100%

Positive form: no-admin warning

75%

Positive form: help channel

100%

Omit needless words: access form

100%

Omit needless words: blocker sentence

100%

Positive form: urgent issues

100%

Active voice throughout

100%

Assertive not hedging

100%

No expletive openings

100%

Content preserved

100%

92%

-1%

Write a Project README for an Open Source Library

Paragraph structure and parallelism

Criteria

Without context

With context

One topic per section

100%

Topic sentence: problem

100%

Topic sentence: alternatives

37%

Parallel comparison structure

100%

Parallel list items

75%

100%

Emphatic sentence endings

100%

Concrete language: problem

100%

Concrete language: not suitable

100%

Serial comma usage

100%

No comma splices

100%

Active voice in README prose

100%

Concise prose

100%

92%

Improve Error Messages for a CLI Tool

Specific language and word placement

Criteria

Without context

With context

Specific cause: Error 1

100%

62%

Omit needless words: Error 2

100%

Active voice: Error 3

100%

Specific language: Error 4

75%

Positive form: Error 5

100%

Concrete state: Error 6

100%

87%

No passive in rewrites

100%

Emphatic endings

100%

Related words together

100%

No 'it is possible/recommended'

100%

Positive form throughout

66%

77%

Action specified

100%

Repository: Dicklesworthstone/pi_agent_rust
Commit: 47823e3

Evaluated: about 1 month ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Rewrite the Onboarding Guide Write a Project README for an Open Source Library Improve Error Messages for a CLI Tool

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.