CtrlK
BlogDocsLog inGet started
Tessl Logo

avoid-ai-writing

Audit and rewrite content to remove AI writing patterns ("AI-isms"). Use this skill when asked to "remove AI-isms," "clean up AI writing," "edit writing for AI patterns," "audit writing for AI tells," or "make this sound less like AI." Supports a detect-only mode, an edit-in-place mode for files, an optional voice profile (casual / professional / technical / warm / blunt), and an iterate-to-convergence pass.

68

Quality

85%

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

73%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 delivers highly actionable, well-sequenced editing workflows with pervasive validation requirements, and it correctly pushes the pattern catalog to a one-level-deep reference file. Its weaknesses are verbosity from extensive rule restatement across sections and bundle/reference mismatches: cited examples/ and detector/ paths do not exist, and one bundled script is orphaned.

Suggestions

Consolidate the editing-pass budget, protected-content, and verification rules into one authoritative section (Editing contract or Output format) and reference it from the other sections instead of restating each rule three to four times.

Fix the bundle/reference mismatches: either include the examples/ directory (README.md and sample configs like technical.json) referenced by the --style section or remove those citations, and reference scripts/markdown-prose.js (or remove it from the bundle) so every bundled file is discoverable.

Trim the research-citation digression in "What this skill is and isn't" to one or two sentences of misuse guidance; the full study citations are context Claude does not need to execute the editing task.

DimensionReasoningScore

Conciseness

The 310-line body is mostly skill-specific policy rather than explanation of concepts Claude already knows, but it is heavily padded with restatement: the editing-pass budget is explained in "Iterate to convergence," again in the marks pass, twice in "Rewrite mode (default)," and again in "Edit mode"; protected-content rules appear in the Editing contract, the marks pass, and the Verification sections. The ~20-line detector-research digression (Liang et al., Jabarian & Imas, arXiv citations) and lawyerly restatements like "A pass count alone is not a stop reason" could be cut to roughly half the length. Not 2: nearly every paragraph carries a skill-specific rule rather than filler or generic explanation.

3 / 5

Actionability

Guidance is largely executable: exact commands with flags and exit codes ("node scripts/normalize-quotes.js <rewritten-prose> --reference <original> --write", "node scripts/check-style.js <file> --config <path>" with "exit 0 clean / 1 hard violation / 2 tool error"), quoted mode-trigger phrases, and per-mode numbered step lists with required output sections. Not 5: "examples/README.md" and "examples/<name>.json" are cited as the schema documentation for --style configs but the examples/ directory does not exist in the bundle, so that guidance dead-ends.

4 / 5

Workflow Clarity

Each mode has a clear numbered sequence (rewrite: audit → rewrite → summarize; edit: read → minimal in-place edits → re-read and verify) with explicit validation checkpoints — the four-item Verification checklist (Editing passes, Checks, Residuals, Stop reason), the before-delivery source comparison, the mechanical preservation validator, and feedback loops (repair within remaining pass budget, re-validate, report unresolved failures). Not 4: validation is not merely present but structurally required at every exit point, including no-op and failure paths.

5 / 5

Progressive Disclosure

The single deep reference (references/patterns.md) is well signaled with a mandatory-load directive and holds the pattern catalog, and scripts are referenced by path — one level deep, matching the anchor-4/5 structure. Not 5: the bundle structure is inconsistent with the body — "examples/README.md", "examples/<name>.json", and "detector/validate.js" are referenced but absent, while bundled scripts/markdown-prose.js is never mentioned anywhere in SKILL.md.

4 / 5

Total

16

/

20

Passed

Description

92%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: explicit what and when, third person, quoted natural trigger phrases, and a full enumeration of modes and options. The only gap is synonym coverage for common alternative phrasings of the request such as "humanize" or "make this sound human."

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "Audit and rewrite content to remove AI writing patterns ('AI-isms')", a "detect-only mode", an "edit-in-place mode for files", an "optional voice profile (casual / professional / technical / warm / blunt)", and an "iterate-to-convergence pass" — giving comprehensive, distinct coverage of what the skill does. Not 4: the actions enumerated cover every operational mode of the skill, not just several with gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is stated up front ("Audit and rewrite content to remove AI writing patterns") and the "when" is given as concrete quoted trigger phrases ("Use this skill when asked to..."). This matches the anchor-5 example structure of a clear what followed by explicit trigger phrases.

5 / 5

Trigger Term Quality

Five natural trigger phrases are quoted verbatim ("remove AI-isms," "clean up AI writing," "edit writing for AI patterns," "audit writing for AI tells," "make this sound less like AI"), which is good coverage. Not 5: common user phrasings for this exact task are missing — "humanize this," "make this sound human/human-written," and "de-slop" are frequent ways users ask for exactly this and none appear.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — AI-ism removal — and the triggers are anchored to AI-specific phrasing ("audit writing for AI tells," "make this sound less like AI"), which a generic editing or proofreading skill would not claim. Minimal conflict risk with other skills.

5 / 5

Total

19

/

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.