CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

avoid-ai-writing-router

Use when a request combines AI-writing audit, rewrite, file editing, voice preservation, false-positive interpretation, verification, or when the user invokes Avoid AI Writing without naming a mode.

Quality

75%

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/avoid-ai-writing-router/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 orchestration overview: lean, largely jargon-free of unnecessary explanation, with an explicit validated multi-stage workflow including a bounded repair loop and clear stop conditions. The main improvements are surfacing the orphaned validation script from the main document and tightening the repeated budget/pass-cap rules.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout — 'Classify the request once, create the smallest useful handoff envelope, then pass that envelope forward' — with no explanation of concepts Claude already knows. Minor trim opportunities keep it from 5: the ten-item envelope field list, and editing-pass budget rules repeated across 'Multi-stage sequencing', 'Boundary changes', and 'Stop conditions'.

4 / 5

Actionability

Concrete, executable routing rules: 'Scan, detect, audit, score, or flag-only requests go to `ai-writing-detector`', a numbered seven-stage sequence, typed-edge semantics, an explicit 'Do not' checklist, and concrete output requirements ('include exactly one full Final rewrite', 'report changed spans without dumping a duplicate of the file'). Not 5 because no worked example of a filled handoff envelope is given, sub-skill paths are bare identifiers, and the actual pass-cap number is deferred to the canonical skill.

4 / 5

Workflow Clarity

The multi-stage flow is a numbered sequence with an explicit validation gate ('preservation-verifier checks before/after material'), a bounded repair feedback loop ('A verifier FAIL returns to the correct repair owner once only if the shared budget has room'), re-verification after repair, an explicitly bounded residual check, and clear stop conditions — matching the anchor for clear sequence with explicit validation steps, error-recovery feedback loops, and checklists.

5 / 5

Progressive Disclosure

The body is a genuine overview: all four references/ files exist and each is named with its purpose ('references/skill-graph.json is the machine-readable source for nodes, typed edges, guards, and loop limits'), and references are one level deep, cross-linking only as siblings. The gap that keeps it from 5 is that scripts/validate_connections.py — a real bundle file validating the graph — is never mentioned in SKILL.md or in any reference file, making it undiscoverable despite 'Review lenses' mentioning 'CI and drift checks'.

4 / 5

Total

17

/

20

Passed

Description

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

The description has a strong, explicit trigger clause with a distinctive specialized vocabulary, but it is a 'when'-only description: the skill's actual behavior (routing across specialized sub-skills) is never stated, and it relies on internal jargon over natural user phrasing. It would benefit most from a leading what-it-does sentence and colloquial trigger synonyms.

Suggestions

Add an explicit 'what' sentence before the trigger clause, e.g. 'Routes AI-writing requests to the narrowest specialized stage (detection, rewrite, file edit, verification) as a bounded workflow across the Avoid AI Writing Skills.'

Include natural user phrasings as triggers: 'make this sound less AI', 'humanize this text', 'check whether this reads as AI-generated'.

Pair internal terms with user-facing equivalents (e.g. 'voice preservation (keep the author's own voice)') so the description is not solely jargon-driven.

DimensionReasoningScore

Specificity

The description enumerates several concrete action areas — 'AI-writing audit, rewrite, file editing, voice preservation, false-positive interpretation, verification' — matching the 'several specific actions with minor gaps' anchor. It falls short of 5 because the skill's own function (routing/coordination) is never named, and above 3 because it lists far more than 1-2 concrete actions.

4 / 5

Completeness

The 'when' is explicit and detailed ('Use when a request combines... or when the user invokes Avoid AI Writing without naming a mode'), but no statement of what the skill does (coordinate a bounded routing workflow) appears — it is only weakly implied by the enumerated task types. This sits between the 'only when present without what' anchor (2) and the clear-half anchor (3), above the midpoint because the when-clause is unusually rich.

3 / 5

Trigger Term Quality

Relevant keywords exist ('audit', 'rewrite', 'file editing', 'verification', 'Avoid AI Writing') but the colloquial phrases users would actually say — 'make this sound less AI', 'humanize', 'reads as AI-generated' — are absent, and 'voice preservation' and 'false-positive interpretation' are internal jargon. This matches 'some relevant keywords but missing common variations or synonyms' rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

Niche-specific vocabulary ('voice preservation', 'false-positive interpretation', 'Avoid AI Writing') plus a named-invocation trigger gives a clear niche with minimal conflict risk, matching 'mostly distinct; minor overlap risk'. Not 5 because the bare terms 'rewrite' and 'file editing' could overlap generic editing skills, bounded only by the 'combines' qualifier.

4 / 5

Total

14

/

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

Path

skills/avoid-ai-writing-router/SKILL.md

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.