Agent skill

AI Writing Detector

by conorbronsdon in conorbronsdon/avoid-ai-writing

A skill your agent uses when the user asks to detect, scan, audit, score, or flag AI-writing patterns without rewriting the text, including requests for a deterministic local detector result when…

MITAuto-check passedWriting & Content

Install AI Writing Detector

skills CLI
$ npx skills add conorbronsdon/avoid-ai-writing --skill ai-writing-detector -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install conorbronsdon/avoid-ai-writing ai-writing-detector --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/conorbronsdon/avoid-ai-writing.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ai-writing-detector .claude/skills/ai-writing-detector && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ai-writing-detector
GitHub stars
4.9k
Token cost
~1.3k tokens
SKILL.md length
584 words
Files
4 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to detect, scan, audit, score, or flag AI-writing patterns without rewriting the text, including requests for a deterministic local detector result when…

  • Works in 6 steps: Pass the supplied text to… → Use --context technical for… → Use --source-mode rendered-markdown for… → …
  • The user asks to detect
  • SKILL.md covers Authority, Connection contract, AI-engineering evidence lens and Preferred path, plus 2 more sections
  • Runs JavaScript scripts from its folder; calls node

What it does

AI Writing Detector is an agent skill from conorbronsdon/avoid-ai-writing. Use when the user asks to detect, scan, audit, score, or flag AI-writing patterns without rewriting the text, including requests for a deterministic local detector result when the host can execute Node.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `agents/openai.yaml`, `scripts/detect.js` and `scripts/patterns.js`).

It sits in Writing & Content, covering Humanizing AI text. The repository describes itself as: Skill that audits and rewrites content to remove AI writing patterns. Use it with your favorite agents including Claude Code, OpenClaw, Codex, and Hermes. The licence is MIT.

When your agent uses it

  • The user asks to detect
  • Flag AI-writing patterns without rewriting the text
  • Including requests for a deterministic local detector result when the host can execute Node

Example prompts

  • “/ai-writing-detector”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Pass the supplied text to scripts/detect.js.
  2. Use --context technical for code-adjacent or technical prose when appropriate. Otherwise use general.
  3. Use --source-mode rendered-markdown for Markdown that carries YAML frontmatter or HTML comments, so unedited metadata is not scored as the…
  4. Report the detector's score, label, issue types, severity, matched text, and suggestions.
  5. Separate deterministic candidate matches from justified editorial findings and observations that only exist in the full rulebook.
  6. Never claim execution unless the command actually ran.

What it can do on your machine

Read from SKILL.md and the folder at commit 5a5cf6a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

AI Writing Detector loads about 1.3k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 584 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from conorbronsdon/avoid-ai-writing at commit 5a5cf6a, republished under its MIT licence (© conorbronsdon). 584 words, ~1,267 tokens.

Download SKILL.mdSave it as .claude/skills/ai-writing-detector/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
ai-writing-detector
description
Use when the user asks to detect, scan, audit, score, or flag AI-writing patterns without rewriting the text, including requests for a deterministic local detector result when the host can execute Node.
version
3.37.0
license
MIT

AI Writing Detector

Run a detect-only review using the original Avoid AI Writing rules. Never rewrite unless the user changes the request.

Authority

The canonical rulebook is ../avoid-ai-writing/SKILL.md. Its cautions about false positives, context, protected material, and authorship claims apply here.

For cross-Skill work, follow ../avoid-ai-writing-router/references/handoff-contract.md and the typed edges in ../avoid-ai-writing-router/references/skill-graph.json.

Connection contract

Incoming

Accept detector work from:

  • avoid-ai-writing-router via ROUTE for detect-only requests, the audit stage of a multi-stage request, or fresh signal collection after another terminal stage returns control to the router.
  • preservation-verifier via bounded RECHECK only when convergence or residual auditing was part of the request.

Do not accept a direct handoff from false-positive-reviewer. That Skill is terminal in the graph and must return control to avoid-ai-writing-router when fresh signal collection is needed. This prevents a reviewer-detector cycle.

Carry forward the canonical context_profile separately from the detector's context_mode, along with protected constraints, pass state, and risk flags. Do not collapse or reset them.

Produce

Update the handoff envelope with:

  • execution_evidence.detector: executed only if the bundled detector actually ran, otherwise model_only.
  • detector_summary.score and label only when produced by executed detector code.
  • detector_summary.issue_types from actual findings.
  • any consequential_authorship_claim risk flag observed in the user's request.
Outgoing
  • FEED findings to voice-preserving-rewriter only when the user also requested returned-text rewriting.
  • FEED findings to file-edit-in-place only when the user explicitly requested mutation of a named file.
  • ESCALATE to false-positive-reviewer when the user asks what the findings can establish about authorship or another consequential conclusion.
  • Otherwise stop after the detect-only result.

Deterministic hits are candidate matches. Keep the engine's public issue types and scores intact, then apply the canonical context exceptions and pass conditions when deciding which hits are justified editorial findings. Neither kind of result is a mandatory edit instruction or authorizes a mutation.

AI-engineering evidence lens

Apply the agency-ai-engineer lens encoded in ../avoid-ai-writing-router/references/agency-role-lenses.md:

  • keep deterministic output separate from model-only observations,
  • preserve the selected context profile and detector mode through downstream handoffs,
  • treat score and label as signals rather than ground truth,
  • consider false positives and genre/register effects,
  • never convert pattern detection into an authorship classifier claim.
Show full SKILL.md (238 more words)Show less

Preferred path

When the current host can execute Node safely:

  1. Pass the supplied text to scripts/detect.js.
  2. Use --context technical for code-adjacent or technical prose when appropriate. Otherwise use general.
  3. Use --source-mode rendered-markdown for Markdown that carries YAML frontmatter or HTML comments, so unedited metadata is not scored as the author's prose. Otherwise leave the default plain.
  4. Report the detector's score, label, issue types, severity, matched text, and suggestions.
  5. Separate deterministic candidate matches from justified editorial findings and observations that only exist in the full rulebook.
  6. Never claim execution unless the command actually ran.

Example:

bash
printf '%s' "$TEXT" | node scripts/detect.js --context general

For a file:

bash
node scripts/detect.js --file path/to/draft.md --context general

For Markdown with frontmatter or HTML comments:

bash
node scripts/detect.js --file path/to/draft.md --source-mode rendered-markdown

If Node or shell execution is unavailable, perform the detect-only workflow from the canonical avoid-ai-writing Skill and explicitly say the deterministic detector was not run.

Stop conditions

Stop here when the request is detect-only. Do not continue into rewrite, file mutation, or interpretation merely because those Skills are available.

A residual RECHECK may run once when requested. It is read-only and does not consume an editing pass; any change it prompts must fit within the requested editing-pass limit, capped at two, and the graph's loop policy.

Output

Return the overall label and score when executed, detected candidate matches grouped by severity, a short contextual assessment that distinguishes justified findings from plausible false positives, execution status, and no rewritten version unless control has explicitly passed to a rewrite owner.

© conorbronsdon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in skills/ai-writing-detector of conorbronsdon/avoid-ai-writing.

  • SKILL.md
  • agents/openai.yaml
  • scripts/detect.js
  • scripts/patterns.js

Open the folder on GitHubat commit 5a5cf6a

Compare with similar skills

AI Writing Detector next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

AI Writing Detector compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI Writing Detector this skillconorbronsdon/avoid-ai-writing4.9k—~1.3kAutomated safety check: PassMIT
HumanizerAzure-Samples/interview-coach-agent-framework17338 repos~5.8kAutomated safety check: PassMIT
User-Facing Text Cleanupguillaumemeyer/watermarks-remover24k—~3.5kAutomated safety check: PassMIT
Install Anti Sloptrycompai/crm11k1 repos~881Automated safety check: PassMIT
Stop SlopXe/site7328 repos~423Automated safety check: PassMIT
Chinese Text Humanizerop7418/Humanizer-zh19k—~2kAutomated safety check: PassMIT

Similar skills

  • Humanizer

    Azure-Samples/interview-coach-agent-framework

    Official

    Remove signs of AI-generated writing from text. An agent skill from Azure-Samples/interview-coach-agent-framework.

    173 GitHub starsUsed in 38 repos~5.8k tokens
    Writing & ContentAuto-check passed
  • User-Facing Text Cleanup

    guillaumemeyer/watermarks-remover

    Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.

    24k GitHub stars~3.5k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Install Anti Slop

    trycompai/crm

    Install and configure the anti-slop Oxlint plugin in a local TypeScript or JavaScript repository.

    11k GitHub starsUsed in 1 repo~881 tokens
    Writing & ContentAuto-check passed
  • Stop Slop

    Xe/site

    Remove AI writing patterns from prose. An agent skill from Xe/site.

    732 GitHub starsUsed in 8 repos~423 tokens
    Writing & ContentAuto-check passed
  • Chinese Text Humanizer

    op7418/Humanizer-zh

    Edits Chinese articles, comments and documents to remove filler, repetition and template phrasing while keeping the facts, the level of certainty and the author's voice.

    19k GitHub stars~2k tokensUpdated 17 days ago
    Writing & ContentAuto-check passed
  • Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.

    1.9k GitHub stars~2.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed

More from conorbronsdon/avoid-ai-writing

  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Auto-check passed
  • Preservation Verifier

    conorbronsdon/avoid-ai-writing

    A skill your agent uses when the user provides an original and rewritten version, asks whether a rewrite preserved protected content, or wants a deterministic check for code, frontmatter, quotes…

    4.9k GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Avoid AI Writing Router

    conorbronsdon/avoid-ai-writing

    A skill your agent uses when a request combines AI-writing audit, rewrite, file editing, voice preservation, false-positive interpretation, verification, or when the user invokes Avoid AI Writing…

    4.9k GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • False Positive Reviewer

    conorbronsdon/avoid-ai-writing

    A skill your agent uses when a user asks what AI-writing flags mean, whether detector output proves AI authorship, or wants a careful interpretation of possible false positives, especially for…

    4.9k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • File Edit In Place

    conorbronsdon/avoid-ai-writing

    A skill your agent uses when the user names a local file and explicitly asks to clean, rewrite, humanize, or remove AI-writing patterns in that file itself, with minimal targeted edits and post-edit…

    4.9k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Voice Preserving Rewriter

    conorbronsdon/avoid-ai-writing

    A skill your agent uses 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.

    4.9k GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed

Questions about AI Writing Detector

What does AI Writing Detector do?

A skill your agent uses when the user asks to detect, scan, audit, score, or flag AI-writing patterns without rewriting the text, including requests for a deterministic local detector result when…. AI Writing Detector is an agent skill from conorbronsdon/avoid-ai-writing. Use when the user asks to detect, scan, audit, score, or flag AI-writing patterns without rewriting the text, including requests for a deterministic local detector result when the host can execute Node.

When should I use AI Writing Detector?

AI Writing Detector fits situations like: the user asks to detect; flag AI-writing patterns without rewriting the text; including requests for a deterministic local detector result when the host can execute Node.

How do I install AI Writing Detector in Claude Code?

Run `npx skills add conorbronsdon/avoid-ai-writing --skill ai-writing-detector -a claude-code`. Or copy the skill folder (skills/ai-writing-detector in conorbronsdon/avoid-ai-writing) into .claude/skills/ai-writing-detector in your project. Claude Code loads it when a task matches its description.

How do I install AI Writing Detector in Codex?

Run `npx skills add conorbronsdon/avoid-ai-writing --skill ai-writing-detector -a codex`. Or copy the skill folder (skills/ai-writing-detector in conorbronsdon/avoid-ai-writing) into .agents/skills/ai-writing-detector in your project. Codex loads it when a task matches its description.

Can I use AI Writing Detector in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add conorbronsdon/avoid-ai-writing --skill ai-writing-detector -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ai-writing-detector, .gemini/skills/ai-writing-detector, .github/skills/ai-writing-detector and .opencode/skills/ai-writing-detector in your project.

What does AI Writing Detector need to run?

Going by SKILL.md and its folder, AI Writing Detector needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.

Does AI Writing Detector access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is AI Writing Detector safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does AI Writing Detector use?

AI Writing Detector is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does AI Writing Detector use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to AI Writing Detector?

Skills that share tags, products or a category with AI Writing Detector: Humanizer (Azure-Samples/interview-coach-agent-framework, 173 stars), User-Facing Text Cleanup (guillaumemeyer/watermarks-remover, 24k stars), Install Anti Slop (trycompai/crm, 11k stars) and Stop Slop (Xe/site, 732 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI Writing Detector?

conorbronsdon (a GitHub user) maintains it in conorbronsdon/avoid-ai-writing, which has 4,938 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

Source: conorbronsdon/avoid-ai-writing on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.