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.

How to use it

  1. Hit Copy SKILL.md — or use the Claude Code line below to get every file.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit conorbronsdon/avoid-ai-writing/skills/avoid-ai-writing-router#main ~/.claude/skills/avoid-ai-writing-router

For one project only, change the path to .claude/skills/avoid-ai-writing-router. This skill also uses skill-graph.json — copying SKILL.md alone won't be enough. See the folder on GitHub.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text119 lines
avoid-ai-writing-router/SKILL.md119 lines7.2 KBpushed 8d agoRawView on GitHub

Avoid AI Writing Router

Coordinate the public Skills as a bounded workflow. Route to the narrowest owner, preserve context between stages, and stop when the requested job is complete. This Skill does not replace the original avoid-ai-writing rulebook.

Authority chain

  1. ../avoid-ai-writing/SKILL.md is the canonical editorial authority.
  2. references/handoff-contract.md defines what context and evidence can cross Skill boundaries.
  3. references/skill-graph.json is the machine-readable source for nodes, typed edges, guards, and loop limits.
  4. references/routing-matrix.md is the human-readable routing table.
  5. references/agency-role-lenses.md defines the architecture, AI-evidence, implementation, and representation review lenses used to inspect the network.

Do not weaken, duplicate, or contradict the canonical Skill's preservation rules, evidence caveats, voice rules, pattern tiers, or pass behavior.

Orchestration model

Classify the request once, create the smallest useful handoff envelope, then pass that envelope forward rather than asking every downstream Skill to infer the same context again.

The envelope should carry only observed or user-provided facts such as:

  • intent and source kind
  • requested editing scope and explicit factual corrections
  • canonical context profile and detector context mode
  • requested voice or supplied style sample
  • protected semantic constraints
  • whether detector, mutation, or verifier execution actually ran
  • detector summary when available
  • preservation status when available
  • risk flags
  • editing passes used and stop limit

Never mark an execution field as executed without host evidence.

Primary routing

  1. Scan, detect, audit, score, or flag-only requests go to ai-writing-detector.
  2. Returned-text rewrite, humanize, clean-up, or remove-AI-isms requests go to voice-preserving-rewriter.
  3. A named file plus an explicit request to change that file goes to file-edit-in-place.
  4. Original plus rewrite, before/after comparison, or preservation validation goes to preservation-verifier.
  5. Claims about proving AI use, cheating, fraud, dishonesty, hiring suitability, or similar consequential conclusions go to false-positive-reviewer.
  6. Explicit invocation of the original Skill may remain in avoid-ai-writing unless the request clearly needs a specialized stage.

Multi-stage sequencing

For requests such as "scan this, rewrite it, and make sure nothing important changed":

  1. ai-writing-detector collects signals when deterministic execution is available, otherwise it performs a model-only audit under the canonical rulebook.
  2. voice-preserving-rewriter rewrites returned text, or file-edit-in-place mutates an explicitly named file.
  3. The mutation owner performs any justified corrective edit within the shared editing-pass budget, then preservation-verifier checks before/after material.
  4. A verifier FAIL returns to the correct repair owner once only if the shared budget has room; that repair consumes the next editing pass.
  5. Verification runs once more after repair when possible.
  6. Residual detection runs only when the user requested convergence or a residual audit. The check is read-only; a resulting edit still needs room in the shared budget.
  7. Stop when no justified in-scope edit remains or after the canonical pass cap. Do not cycle indefinitely.

Typed edges

Use the edge semantics in references/handoff-contract.md:

  • ROUTE: choose the owner.
  • FEED: pass evidence without turning it into a command.
  • VERIFY: require a before/after preservation check.
  • REPAIR: return a failed preservation result to the correct mutation owner.
  • RECHECK: run one bounded residual check when requested.
  • ESCALATE: move uncertain or consequential authorship interpretation to false-positive-reviewer.

Conditional guards are not graph edges. Encode them in skill-graph.json guards and the handoff envelope (protected_constraints, human_representation_sensitive) per references/handoff-contract.md.

Conditional human-representation guard

If the source itself is an image prompt, video prompt, storyboard, shot description, or creative brief that describes people, set human_representation_sensitive: true and preserve identity-sensitive details as protected constraints.

Use the agency-inclusive-visuals-specialist lens from references/agency-role-lenses.md to protect cultural, geographic, age, disability, attire, skin-tone/lighting, and physical-reality details. Do not route ordinary prose to a visual workflow just because it mentions a person.

Review lenses

Apply these design checks when the network changes or when a complex request exposes a boundary problem:

  • agency-software-architect: ownership, dependency direction, bounded loops, fallback, reversibility.
  • agency-ai-engineer: detector semantics, uncertainty, false-positive handling, context propagation, evaluation.
  • agency-senior-developer: executable paths, error propagation, file mutation evidence, CI and drift checks.
  • agency-inclusive-visuals-specialist: representation preservation only for visual prompts and briefs involving people.

These are review lenses, not hidden public dependencies. If an external agency Skill is not available in the current host, apply the encoded lens without claiming it ran.

Boundary changes

Return control to the router instead of continuing locally when:

  • the job changes from read-only to mutation,
  • the target changes from returned text to a named file or the reverse,
  • required before/after evidence is missing,
  • deterministic execution requested by the workflow is unavailable,
  • the user moves from pattern analysis to a consequential authorship claim,
  • a verifier fails and identifies a different repair owner.

Preserve the existing handoff envelope and change only fields affected by the new decision.

Stop conditions

Stop when the user's requested stage is complete and any required verification gate has passed, been explicitly reported as unavailable, or failed with no editing pass left for repair. Report an exhausted-budget failure without calling the result verified.

Do not:

  • infer authorship from detector output,
  • mutate a file without user authorization,
  • hide a verifier failure,
  • re-run stages simply because another Skill exists,
  • exceed the canonical rewrite pass cap,
  • route unrelated writing or coding requests into this Plugin merely because they mention AI.

Output

Return the selected workflow result only after the requested stages and available verification finish. For returned-text rewriting, include exactly one full Final rewrite; do not expose a draft that a later stage superseded. For named-file editing, report changed spans without dumping a duplicate of the file. For multi-stage work, state which stages actually ran, which were model-only, which deterministic checks executed, how many editing passes were used, whether any repair occurred, and the final preservation status or unresolved failure.

1---
2name: avoid-ai-writing-router
3description: 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.
4---
5 
6# Avoid AI Writing Router
7 
8Coordinate the public Skills as a bounded workflow. Route to the narrowest owner, preserve context between stages, and stop when the requested job is complete. This Skill does not replace the original `avoid-ai-writing` rulebook.
9 
10## Authority chain
11 
121. `../avoid-ai-writing/SKILL.md` is the canonical editorial authority.
132. `references/handoff-contract.md` defines what context and evidence can cross Skill boundaries.
143. `references/skill-graph.json` is the machine-readable source for nodes, typed edges, guards, and loop limits.
154. `references/routing-matrix.md` is the human-readable routing table.
165. `references/agency-role-lenses.md` defines the architecture, AI-evidence, implementation, and representation review lenses used to inspect the network.
17 
18Do not weaken, duplicate, or contradict the canonical Skill's preservation rules, evidence caveats, voice rules, pattern tiers, or pass behavior.
19 
20## Orchestration model
21 
22Classify the request once, create the smallest useful handoff envelope, then pass that envelope forward rather than asking every downstream Skill to infer the same context again.
23 
24The envelope should carry only observed or user-provided facts such as:
25 
26- intent and source kind
27- requested editing scope and explicit factual corrections
28- canonical context profile and detector context mode
29- requested voice or supplied style sample
30- protected semantic constraints
31- whether detector, mutation, or verifier execution actually ran
32- detector summary when available
33- preservation status when available
34- risk flags
35- editing passes used and stop limit
36 
37Never mark an execution field as `executed` without host evidence.
38 
39## Primary routing
40 
411. Scan, detect, audit, score, or flag-only requests go to `ai-writing-detector`.
422. Returned-text rewrite, humanize, clean-up, or remove-AI-isms requests go to `voice-preserving-rewriter`.
433. A named file plus an explicit request to change that file goes to `file-edit-in-place`.
444. Original plus rewrite, before/after comparison, or preservation validation goes to `preservation-verifier`.
455. Claims about proving AI use, cheating, fraud, dishonesty, hiring suitability, or similar consequential conclusions go to `false-positive-reviewer`.
466. Explicit invocation of the original Skill may remain in `avoid-ai-writing` unless the request clearly needs a specialized stage.
47 
48## Multi-stage sequencing
49 
50For requests such as "scan this, rewrite it, and make sure nothing important changed":
51 
521. `ai-writing-detector` collects signals when deterministic execution is available, otherwise it performs a model-only audit under the canonical rulebook.
532. `voice-preserving-rewriter` rewrites returned text, or `file-edit-in-place` mutates an explicitly named file.
543. The mutation owner performs any justified corrective edit within the shared editing-pass budget, then `preservation-verifier` checks before/after material.
554. A verifier `FAIL` returns to the correct repair owner once only if the shared budget has room; that repair consumes the next editing pass.
565. Verification runs once more after repair when possible.
576. Residual detection runs only when the user requested convergence or a residual audit. The check is read-only; a resulting edit still needs room in the shared budget.
587. Stop when no justified in-scope edit remains or after the canonical pass cap. Do not cycle indefinitely.
59 
60## Typed edges
61 
62Use the edge semantics in `references/handoff-contract.md`:
63 
64- `ROUTE`: choose the owner.
65- `FEED`: pass evidence without turning it into a command.
66- `VERIFY`: require a before/after preservation check.
67- `REPAIR`: return a failed preservation result to the correct mutation owner.
68- `RECHECK`: run one bounded residual check when requested.
69- `ESCALATE`: move uncertain or consequential authorship interpretation to `false-positive-reviewer`.
70 
71Conditional guards are not graph edges. Encode them in `skill-graph.json` `guards` and the handoff envelope (`protected_constraints`, `human_representation_sensitive`) per `references/handoff-contract.md`.
72 
73## Conditional human-representation guard
74 
75If the source itself is an image prompt, video prompt, storyboard, shot description, or creative brief that describes people, set `human_representation_sensitive: true` and preserve identity-sensitive details as protected constraints.
76 
77Use the `agency-inclusive-visuals-specialist` lens from `references/agency-role-lenses.md` to protect cultural, geographic, age, disability, attire, skin-tone/lighting, and physical-reality details. Do not route ordinary prose to a visual workflow just because it mentions a person.
78 
79## Review lenses
80 
81Apply these design checks when the network changes or when a complex request exposes a boundary problem:
82 
83- `agency-software-architect`: ownership, dependency direction, bounded loops, fallback, reversibility.
84- `agency-ai-engineer`: detector semantics, uncertainty, false-positive handling, context propagation, evaluation.
85- `agency-senior-developer`: executable paths, error propagation, file mutation evidence, CI and drift checks.
86- `agency-inclusive-visuals-specialist`: representation preservation only for visual prompts and briefs involving people.
87 
88These are review lenses, not hidden public dependencies. If an external agency Skill is not available in the current host, apply the encoded lens without claiming it ran.
89 
90## Boundary changes
91 
92Return control to the router instead of continuing locally when:
93 
94- the job changes from read-only to mutation,
95- the target changes from returned text to a named file or the reverse,
96- required before/after evidence is missing,
97- deterministic execution requested by the workflow is unavailable,
98- the user moves from pattern analysis to a consequential authorship claim,
99- a verifier fails and identifies a different repair owner.
100 
101Preserve the existing handoff envelope and change only fields affected by the new decision.
102 
103## Stop conditions
104 
105Stop when the user's requested stage is complete and any required verification gate has passed, been explicitly reported as unavailable, or failed with no editing pass left for repair. Report an exhausted-budget failure without calling the result verified.
106 
107Do not:
108 
109- infer authorship from detector output,
110- mutate a file without user authorization,
111- hide a verifier failure,
112- re-run stages simply because another Skill exists,
113- exceed the canonical rewrite pass cap,
114- route unrelated writing or coding requests into this Plugin merely because they mention AI.
115 
116## Output
117 
118Return the selected workflow result only after the requested stages and available verification finish. For returned-text rewriting, include exactly one full Final rewrite; do not expose a draft that a later stage superseded. For named-file editing, report changed spans without dumping a duplicate of the file. For multi-stage work, state which stages actually ran, which were model-only, which deterministic checks executed, how many editing passes were used, whether any repair occurred, and the final preservation status or unresolved failure.
119 

Discussion

From GitHub

2 threads

Alternatives

Also in Editing & polish