CtrlK
BlogDocsLog inGet started
Tessl Logo

ai-writing-detector

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.

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

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong, lean detect-only skill body: executable commands verified against the real bundled script, a well-sequenced preferred path with fallback and stop conditions, and appropriate externalization of the rulebook and pattern data. Remaining gaps are minor — no failure-handling for detector errors, slight duplication between the Authority and evidence-lens sections, and non-linked file references.

Suggestions

Add a short failure-handling step to the Preferred path, e.g., "If the command exits 2, report the usage/I/O error and fall back to the manual detect-only workflow".

Trim the evidence-lens bullets that duplicate the Authority section's cautions, and reduce the three bash examples to the stdin and file variants (the --source-mode flag can be shown once).

Convert referenced file paths (../avoid-ai-writing/SKILL.md, router references, scripts/detect.js) into markdown links so navigation is one click.

DimensionReasoningScore

Conciseness

The body is dense and skill-specific — no generic concept explanations, and the heavy pattern data is correctly left in scripts/patterns.js. It stops short of anchor 5 because the "AI-engineering evidence lens" bullets partially restate cautions already covered in the Authority section, and three near-identical bash examples (stdin, file, rendered-markdown) could be compressed to two. It is well above anchor 3 since nothing explains material Claude already knows.

4 / 5

Actionability

The Preferred path gives copy-paste-ready commands ("printf '%s' \"$TEXT\" | node scripts/detect.js --context general", "--file path/to/draft.md --source-mode rendered-markdown") whose flags and values match the actual bundled scripts/detect.js interface, covers the common input cases, specifies decision criteria for --context and --source-mode, and defines the fallback when Node is unavailable. This matches anchor 5: fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The Preferred path is a clear numbered sequence with condition points, an explicit fallback branch, an execution-integrity checkpoint ("Never claim execution unless the command actually ran", enforced by execution_evidence executed vs model_only), and explicit Stop conditions. It misses anchor 5 because there is no guidance for handling command failure (detect.js exits 2 on usage or I/O errors), leaving a minor validation gap — though the operation is read-only, so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

Structure is good and matches the actual bundle: the rulebook detail is delegated to ../avoid-ai-writing/SKILL.md, graph policy to the router references, and pattern mass to scripts/, with one-level-deep, clearly named paths. It falls short of anchor 5 because references are bare code paths rather than navigable links, and the lens bullets plus several contract details are inlined in SKILL.md where anchor 5's example would signal them as short pointer references.

4 / 5

Total

17

/

20

Passed

Description

75%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-constructed trigger-first description with an explicit use-when clause, natural action verbs, and a clear detect-only boundary. Its main weakness is that the capability ("what") is only implicit in the trigger verbs rather than stated as its own concrete statement, and common user phrasings like "AI-generated text" are missing.

Suggestions

Add a leading third-person capability statement before the trigger clause, e.g., "Scores text for AI-writing patterns and reports label, score, and findings without rewriting; use when the user asks to detect, scan, audit, score, or flag AI-writing patterns..."

Include natural noun-phrase variations users actually say, such as "AI-generated text" or "machine-written prose", alongside "AI-writing patterns".

DimensionReasoningScore

Specificity

The description lists several concrete actions ("detect, scan, audit, score, or flag AI-writing patterns") plus a scope boundary ("without rewriting the text") and a mechanism condition ("deterministic local detector result when the host can execute Node"). It sits at anchor 4 rather than 5 because the verbs are near-synonyms around one detection capability and it never states what output the skill produces (score, label, findings by severity).

4 / 5

Completeness

The "when" is explicit and detailed ("Use when the user asks to detect, scan, audit, score, or flag...") and a "what" is implied by those same verbs, but there is no standalone third-person capability statement (e.g., "Runs a detect-only analysis and reports score, label, and findings"). That fits anchor 4 — both present, one could be more explicit — rather than 5, and it is clearly above anchor 3 where the "when" would be missing or weakly implied.

4 / 5

Trigger Term Quality

Good keyword coverage with five natural verbs users would say ("detect, scan, audit, score, or flag") plus the domain phrase "AI-writing patterns". It misses anchor 5 because common noun-phrase variations such as "AI-generated text", "machine-written", or "ChatGPT-style writing" are absent.

4 / 5

Distinctiveness Conflict Risk

"without rewriting the text" carves out a clear detect-only niche distinct from rewrite-oriented skills, but the trigger verbs would equally fire a broader sibling skill (e.g., a general avoid-ai-writing skill that includes rewriting). Mostly distinct with minor overlap risk against closely related skills is exactly anchor 4; it does not reach anchor 5's "minimal conflict risk" given that sibling overlap.

4 / 5

Total

16

/

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.