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.

65

Quality

82%

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

The canonical home for this skill is avoid-ai-writing in conorbronsdon/avoid-ai-writing

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.

A well-structured, highly disciplined policy skill: modes are crisply defined, validation and feedback loops are exceptionally thorough, and the heavy pattern catalog is properly externalized to a one-level-deep reference. The main costs are cross-section redundancy that inflates the 317-line body, and dangling bundle paths (examples/README.md, examples/<name>.json, detector/validate.js) referenced in the --style and mechanical-check sections that don't resolve.

Suggestions

Consolidate the rules stated multiple times across sections — protected-content exemptions (Editing contract, marks pass, Output format residuals) and editing-pass accounting (Iterate to convergence, marks pass, Output format) — into single stated-once sections; this is the largest conciseness lever in the file.

Fix or remove the dangling bundle paths: "examples/README.md", "examples/<name>.json", and "detector/validate.js" are referenced with operational weight (config schema, verification command) but do not exist in this bundle — either ship them or explicitly mark them as not bundled.

Inline a minimal --style config example (one small JSON snippet) so the preferred config path is executable without the missing examples/README.md, and add a short worked example of the <rewritten-prose> scratch-file marks-pass workflow.

DimensionReasoningScore

Conciseness

The body does not explain concepts Claude already knows — nearly all 317 lines are novel operational policy — but the same rules are restated multiple times: protected-content gates appear in the Editing contract, the marks-pass paragraph, and the Output format residuals section, and editing-pass accounting is covered in "Iterate to convergence," "Automatic marks pass," and again across ~10 overlapping Output-format paragraphs. This matches "mostly efficient but includes some unnecessary explanation or could be tightened." Not a 2 because the verbosity is redundant policy rather than padded filler or pedagogy, and not a 4 because the cross-section repetition is substantial enough that consolidating would meaningfully shrink the file.

3 / 5

Actionability

Concrete, executable commands are given with exact invocations 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", "node detector/validate.js --residual-policy warn <original> <rewritten>") plus explicit natural-language invocation examples. Not a 5 because the --style config schema is deferred to "examples/README.md", which does not exist in the bundle, and the <rewritten-prose> scratch-file workflow is described abstractly without a worked example — minor gaps that keep it from fully covering the common cases copy-paste ready.

4 / 5

Workflow Clarity

Each mode has an explicit numbered step list (rewrite: Audit/Rewrite/Summarize; detect: Audit/Assess; edit: Read/Edit-in-place/Verify), and validation is everywhere: re-read the file after editing, a four-item Verification checklist (Editing passes, Checks, Residuals, Stop reason), compare-final-with-source accounting, repair-within-remaining-budget feedback loops, and explicit failure reporting when a check cannot run. This matches the anchor-5 pattern of clear sequencing with explicit validation and error-recovery loops; the "Only proceed when validation passes" discipline is fully present.

5 / 5

Progressive Disclosure

The 107KB pattern catalog is correctly split into references/patterns.md, clearly signaled once at the top ("read references/patterns.md in full") and one level deep, and the two invoked scripts are referenced with exact runnable paths that resolve in the bundle (markdown-prose.js is an internal dependency of those scripts, appropriately not surfaced). Not a 5 because the body references paths that do not exist in this bundle — "examples/README.md" ("Schema and rationale: examples/README.md"), "examples/<name>.json", and "detector/validate.js" — and the severity-tier catalog section (P0/P1/P2 pattern lists) partially duplicates material that lives in the reference file. Not a 3 because the references that do exist are clearly signaled, correctly scoped, and easy to navigate.

4 / 5

Total

16

/

20

Passed

Description

87%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 what the skill does and when to invoke it, with multiple natural quoted trigger phrases and named modes/voice profiles. The only weaknesses are minor: a few common user synonyms ("humanize," "make it sound human") are absent, and the --style/--context options from the body are not surfaced in the description.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Audit and rewrite content to remove AI writing patterns," "a detect-only mode," "an edit-in-place mode for files," "an optional voice profile (casual / professional / technical / warm / blunt)," "an iterate-to-convergence pass" — matching the anchor for several specific actions with minor gaps (the --style/house-style and --context options are not surfaced). Not a 5 because coverage of the skill's feature set is incomplete rather than comprehensive, and not a 3 because far more than 1-2 concrete actions are named.

4 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: what ("Audit and rewrite content to remove AI writing patterns ('AI-isms')") and when ("Use this skill when asked to 'remove AI-isms,' 'clean up AI writing,' ...") — mirroring the anchor-5 good example structure exactly. Not a 4 because the 'when' is fully explicit with quoted triggers, not merely present.

5 / 5

Trigger Term Quality

Five natural quoted trigger phrases are given ("remove AI-isms," "clean up AI writing," "edit writing for AI patterns," "audit writing for AI tells," "make this sound less like AI") — good keyword coverage with genuine user phrasing. Not a 5 because common synonyms users actually say are missing (e.g., "humanize this," "make it sound human," "de-slop," "de-AI my text"), which anchor 5's comprehensive-synonym standard expects.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (AI-writing-pattern removal) with distinct, unmistakable triggers like "make this sound less like AI" and "audit writing for AI tells," which no generic editing or proofreading skill would claim. Minimal conflict risk; not a 4 because the quoted triggers leave essentially no overlap ambiguity with related writing skills.

5 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

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.