CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

voice-preserving-rewriter

Use when the user asks to rewrite, humanize, clean up, or remove AI-isms from text while preserving the writer's voice, facts, intent, structure, register, and protected material.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/voice-preserving-rewriter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is a tightly written procedural contract with a clear sequenced workflow, explicit verification feedback loop, and disciplined stop conditions. Its weaknesses are the delegation of the core editing rules to a sibling file absent from this bundle and the scattered, hard-to-parse editing-pass rules.

Suggestions

Inline a minimal summary of the core editing rules (pattern categories, rewrite mechanics, protected-region handling) in this SKILL.md so the skill remains actionable when the sibling `../avoid-ai-writing/SKILL.md` is not present.

Split workflow step 9 into short, separate rules for pass counting and consolidate the pass-state rules currently repeated across Workflow, Repair path, Stop conditions, and Output into a single section.

Reproduce or summarize the essential fields of the referenced handoff files (handoff-contract.md, skill-graph.json) within the bundle, or add a references/ directory containing them, so navigation to detail content does not depend on external skills.

DimensionReasoningScore

Conciseness

The body is dense, directive prose with no padding or explanation of concepts Claude already knows — every section issues rules rather than background. It falls short of the 5 anchor because the editing-pass rules are stated redundantly across Workflow step 9, the Repair path, Stop conditions, and Output, which could be consolidated. It is well above the 3 anchor since there is no genuinely unnecessary explanation.

4 / 5

Actionability

Process guidance is concrete ("increment the editing-pass count from 0 to 1", "Change only the spans implicated by the blocking preservation errors", "Return the full text exactly once under **Final rewrite**"), but the core how-to-rewrite rules are delegated: "Rewrite text using the complete rules in `../avoid-ai-writing/SKILL.md`. Its editing contract is the authority for … mechanics", and that file is not part of this bundle. This matches the 3 anchor (some concrete guidance but incomplete, missing key details) rather than the 4 anchor, whose gaps are minor rather than the skill's central mechanics.

3 / 5

Workflow Clarity

A clear 10-step workflow with an explicit verification checkpoint ("Send before/after content to `preservation-verifier`") and a genuine feedback loop (FAIL → repair implicated spans → re-verify once → stop), satisfying the anchors above 3. It misses the 5 anchor because step 9 packs the entire pass-counting protocol into one convoluted compound sentence and pass-state rules are scattered across four sections, making the sequence harder to follow than the anchor's crisp checklist style.

4 / 5

Progressive Disclosure

Sections are well organized (Connection contract, Conditional guard, Workflow, Repair path, Voice handling, Stop conditions, Output) and references are clearly signaled, but every substantive detail file — the editing contract, handoff contract, skill graph, and role lenses — lives outside this bundle ("../avoid-ai-writing/SKILL.md", "../avoid-ai-writing-router/references/…") and no references/, scripts/, or assets/ directories exist here, so the overview-to-detail navigation cannot be exercised within the bundle. This sits between the 3 anchor (organization present but the detail layer fails) and the 4 anchor; the missing authority content is more than a minor organization gap.

3 / 5

Total

14

/

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 both capability and explicit trigger conditions in the canonical 'Use when…' form, with concrete action verbs and a distinctive AI-ism-removal niche. The main improvement area is broader natural-language synonym coverage for trigger terms.

Suggestions

Add common user phrasings as triggers, e.g. 'make text sound more human or natural', 'less robotic', or 'make it sound like me', to broaden trigger term coverage.

Mention the rewrite verification/preservation-check capability so the description covers the full scope of what the skill does, not just the rewriting step.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("rewrite, humanize, clean up, or remove AI-isms from text") plus a specific preservation constraint list ("voice, facts, intent, structure, register, and protected material"), but the verbs are near-synonyms within a single domain and coverage has minor gaps (no mention of the verification loop or text types handled). It exceeds the 3 anchor (only 1-2 concrete actions) but does not fully match the 5 anchor's comprehensive multi-capability coverage.

4 / 5

Completeness

It explicitly answers both questions: what ("rewrite, humanize, clean up, or remove AI-isms from text while preserving the writer's voice, facts, intent, structure, register, and protected material") and when ("Use when the user asks to…") with concrete trigger phrases, matching the 5 anchor pattern exactly. Not the 4 anchor, since the 'when' clause is explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

"rewrite", "humanize", "clean up", and "remove AI-isms" are terms users naturally say when needing this skill. A few common variations are missing (e.g., "make it sound human/natural", "less robotic", "make it sound like me"), which keeps it below the 5 anchor's comprehensive synonym coverage but clearly above the 3 anchor's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

"remove AI-isms" and "humanize" give the skill a clear niche with minimal conflict risk, but the broad verbs "rewrite" and "clean up" overlap with generic editing/proofreading skills, matching the 4 anchor (mostly distinct, minor overlap risk). It is more distinct than the 3 anchor's 'somewhat specific' and not the 5 anchor because the generic rewrite trigger could fire for ordinary editing requests.

4 / 5

Total

17

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

conorbronsdon/avoid-ai-writing

Path

skills/voice-preserving-rewriter/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.