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

80%

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

70%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 well-structured orchestration contract with an exemplary bounded verify-repair workflow, but it is not self-sufficient: the actual editing rules, output format, and lens definitions all live in sibling-skill files that are absent from the bundle, so the skill cannot execute its core function as provided. Redundant restatements of pass-counting rules across three sections also leave some tightening room.

Suggestions

Inline the essential editing rules or at least a minimal example of the rewrite-mode Output format (including the four Verification items) instead of delegating entirely to `../avoid-ai-writing/SKILL.md`, which is not present in the bundle — the skill currently cannot perform a rewrite standalone.

Ship the cross-skill dependencies as bundle files (e.g., under `references/`) or correct the sibling paths, since `../avoid-ai-writing/SKILL.md` and `../avoid-ai-writing-router/references/*` do not resolve from this skill's directory.

Consolidate the editing-pass counting rules, which are currently stated in Workflow step 9, the Repair path, and Stop conditions, into a single section to remove redundancy.

DimensionReasoningScore

Conciseness

Dense, contract-style procedural prose that assumes Claude's competence ("Do not replace one AI cliché with another") and explains nothing the model already knows. Not a 5 because the editing-pass counting rules are stated three times (Workflow step 9, Repair path, Stop conditions) and protection rules repeat across sections.

4 / 5

Actionability

Concrete on process — named handoff operations (ROUTE, FEED, REPAIR, VERIFY), canonical voice profiles ("casual, professional, technical, warm, or blunt"), and bounded repair rules ("Change only the spans implicated by the blocking preservation errors"). Not a 4 because the core editing contract, the rewrite-mode Output format ("including its four Verification items"), and the representation lens are all delegated to files that do not exist in the bundle, leaving key operational details missing as written.

3 / 5

Workflow Clarity

A clear 10-step workflow with explicit validation (step 10 sends before/after content to preservation-verifier) and a bounded feedback loop ("If `pass.index` has reached `pass.max`, do not repair"; "Return to `preservation-verifier` once... Do not cycle again"). This matches the anchor-5 pattern of explicit validation checkpoints plus error recovery.

5 / 5

Progressive Disclosure

The body is well-sectioned (Connection contract, Conditional guard, Workflow, Repair path, Voice handling, Stop conditions, Output) with clearly signaled one-level references. Not a 4 because every reference points outside the bundle to files that do not exist here (`../avoid-ai-writing/SKILL.md`, `../avoid-ai-writing-router/references/handoff-contract.md`, `skill-graph.json`, `agency-role-lenses.md`), so the substantive rulebook is entirely unverifiable and navigation fails.

3 / 5

Total

15

/

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 with an explicit "Use when" trigger clause, natural user phrasings, and a clear statement of what is preserved. Its only weaknesses are near-synonymous action verbs and a few missing natural trigger variants, which create minor overlap risk with generic editing skills.

DimensionReasoningScore

Specificity

"rewrite, humanize, clean up, or remove AI-isms from text" lists several concrete actions, and the preservation list ("voice, facts, intent, structure, register, and protected material") adds coverage. Not a 5 because the four verbs are near-synonymous variants of one core rewriting operation rather than distinct capabilities.

4 / 5

Completeness

Explicitly answers when ("Use when the user asks to rewrite, humanize, clean up, or remove AI-isms from text") with concrete trigger phrases, and what (rewrite while preserving the enumerated attributes). Both halves are explicit and concrete.

5 / 5

Trigger Term Quality

"rewrite", "humanize", "clean up", and "remove AI-isms" are phrases users naturally say when they need this skill. Not a 5 because common variations like "sound more human", "sound natural", "less robotic", or "make it sound like me" are missing.

4 / 5

Distinctiveness Conflict Risk

"humanize" and "AI-isms" pin a clear niche with minimal conflict from unrelated skills. Not a 5 because the unqualified verbs "rewrite" and "clean up" text could also trigger generic editing or proofreading skills.

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.