CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

61

Quality

77%

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

62%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-sequenced orchestration body with excellent workflow clarity and a genuine verification feedback loop, but it functions only as a connector: the editing contract, rules, and output format it defers to are in sibling files that are absent from this bundle, and its own pass-counting rules are repeated across several sections. As shipped in this evaluation copy it cannot complete its primary deliverable standalone.

Suggestions

Bundle or inline the essential editing rules and the rewrite-mode Output format (including the four Verification items) so the skill does not depend on the missing ../avoid-ai-writing/SKILL.md for its primary deliverable, or ensure the referenced sibling files ship with the skill.

Consolidate the editing-pass counting logic — currently restated in Workflow step 9, step 10, the Repair path, and Stop conditions — into a single authoritative statement and reference it from the other sections.

Add one compact worked example (justified finding → minimal in-scope rewrite, plus the final report shape) so a reader can see the pass-count and residual reporting behavior in action.

DimensionReasoningScore

Conciseness

The prose is dense and rule-only with zero padding or explanation of concepts Claude already knows, but it could be tightened: the editing-pass counting rules are stated four times (Workflow step 9, step 10, Repair path steps 1/4/6, Stop conditions), 'preserve content that already sounds human' appears at both line 24 and step 4, and step 7's protected-region rules repeat the Produce section. Not a 2 — there is no verbosity for its own sake — but the duplication is more than 'minor instances that could be trimmed', so anchor 3 fits better than 4.

3 / 5

Actionability

The orchestration guidance is concrete (named canonical voice profiles, explicit handoff envelope fields, a stepwise repair procedure with hard stop rules), and per the rubric's code_vs_instruction note the absence of code is not itself penalized. However, the two things that make the skill executable — the editing rules ('the complete rules in ../avoid-ai-writing/SKILL.md... is the authority') and the required Output format ('Follow the canonical ../avoid-ai-writing/SKILL.md rewrite-mode Output format') — are delegated entirely to a file that does not exist in this bundle, leaving key details missing. That is the anchor-3 case ('some concrete guidance but incomplete'), not 4 ('minor gaps').

3 / 5

Workflow Clarity

A clear 10-step sequence with validation checkpoints (audit before editing in step 3, review before presenting in step 9, verifier handoff in step 10) and a full feedback loop in the Repair path: check pass state, repair only implicated spans, return to the verifier once, then stop and report rather than cycling. This matches the anchor-5 example (validate → fix → re-verify → only-then-proceed) including error-recovery behavior.

5 / 5

Progressive Disclosure

References are clearly signaled with stated purposes and are only one level deep (../avoid-ai-writing/SKILL.md, ../avoid-ai-writing-router/references/handoff-contract.md, skill-graph.json, agency-role-lenses.md), which is structurally right. But none of those files resolve in this bundle — there is no local references/ directory and the sibling skills are absent — so the skill's core content lives in files that cannot be reached, and navigation effectively breaks. Clearly-signaled but non-resolving dependent references fall between the 'references present but not clearly signaled' anchor 3 and the well-split anchor 4; the missing files make it a 3.

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 well-formed description with an explicit 'Use when' trigger clause, natural trigger terms, and a specific preservation contract. Its only gaps are a couple of missing colloquial trigger variants and an unnamed deliverable.

Suggestions

Add common colloquial triggers such as 'make it sound human/natural' or 'less robotic' to broaden trigger-term coverage.

Name the deliverable explicitly (e.g., 'returns the rewritten text') so the 'what' covers the output, not just the operation.

DimensionReasoningScore

Specificity

The description lists several concrete action verbs ("rewrite, humanize, clean up, or remove AI-isms from text") plus a rich preservation scope ("voice, facts, intent, structure, register, and protected material"). It stops short of anchor 5 because the verbs are largely synonyms for one de-AI-ifying rewrite operation and the deliverable (a returned rewritten text) is never named; not below 4 because coverage within the niche is thorough.

4 / 5

Completeness

Both halves are explicit: "Use when the user asks to rewrite, humanize, clean up, or remove AI-isms from text" answers *when* with concrete trigger phrases, and the same clause plus the preservation list answers *what*. This matches the anchor-5 pattern of the good examples.

5 / 5

Trigger Term Quality

"rewrite", "humanize", "clean up", and "remove AI-isms" are natural user phrasings with good synonym coverage. It misses a few common variations users actually say ("make it sound human/natural", "less robotic", "tone down the AI voice"), which keeps it below the comprehensive anchor 5 but comfortably above anchor 3.

4 / 5

Distinctiveness Conflict Risk

"remove AI-isms" carves a clear niche distinct from generic editing/grammar skills. Minor overlap risk remains with plain "rewrite/polish my text" requests and closely related sibling voice-editing skills, so it sits at anchor 4 rather than 5.

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