agentleFS
gohypergiantgohypergiant/agent-skills/skills/accelint-english-manager/SKILL.md

accelint-english-manager

Skill25 starsChanged 54 days agoApache-2.0View on GitHub

Use when the user wants prose rewritten, tightened, audited, simplified, polished, humanized, grammar-checked, or made plainer, clearer, shorter, easier to scan, or easier to act on without changing the intended meaning, audience, tone, or explicit constraints. Trigger on requests such as plain English, simple English, make this clearer, make this more direct, clean this up, edit this, review this writing, grammar check, too wordy, too formal, less fluffy, friendlier, shorter, audit then rewrite, keep the tone, mode=strict, STE, ASD-STE100, or ADHD-friendly. Also trigger for docs, prompts, emails, UI copy, support replies, release notes, status updates, incident notes, procedural text, and other LLM-written prose. Prefer this skill when the main job is improving English prose or preserving tone while increasing clarity, including audit-only requests and exact-text-preservation constraints, but not when the real task is fact-checking, policy setting, or substantive content design.

We split this skill into the rules it gives an agent

70 rules. About 0 are common, 60 are distinctive, and 10 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈60

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 10

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use plain, direct English that is easy to read, easy to scan, and easy to act on.

    line 12
  2. Distinctive:

    Do not optimize for brevity alone.

    line 14
  3. Distinctive:

    Use these together. They are not separate modes.

    line 21
  4. Distinctive:

    Keep real uncertainty, real nuance, and real obligation levels.

    line 31
  5. Distinctive:

    Do not claim official ASD-STE100 compliance.

    line 32
  6. Distinctive:

    Do this first for drafting or rewriting tasks unless the user already specified the mode explicitly.

    line 39
  7. Distinctive:

    If the user did not choose a mode, ask a short clarifying question instead of assuming.

    line 45
  8. Distinctive:

    If the user asks for only the rewrite, return only the rewrite.

    line 56
  9. Distinctive:

    Do this before you rewrite or restructure anything.

    line 61
  10. Distinctive:

    If a style rule conflicts with an explicit user constraint, the constraint wins.

    line 71
  11. Very specific:

    Do not treat mode=strict as permission to broaden the task casually.

    line 82
  12. Distinctive:

    Use this method unless the task clearly calls for a stricter overlay.

    line 87
  13. Distinctive:

    Do not add a preamble when the answer works better without one.

    line 97
  14. Distinctive:

    Write the clearest accurate sentence you can.

    line 101
  15. Distinctive:

    prefer concrete actions and results over abstraction

    line 103
  16. Distinctive:

    use short familiar words when they keep the same meaning

    line 104
  17. Distinctive:

    remove filler, recap padding, and inflated phrasing

    line 105
  18. Distinctive:

    prefer active voice when it improves clarity

    line 107
  19. Distinctive:

    If a simpler word would reduce accuracy, keep the precise word.

    line 109
  20. Distinctive:

    Do not rotate synonyms just to avoid repetition.

    line 115
  21. Distinctive:

    Use light ADHD-friendly shaping by default:

    line 119
  22. Distinctive:

    keep sentences and paragraphs bounded

    line 120
  23. Distinctive:

    keep one main action or fact per sentence when possible

    line 121
  24. Distinctive:

    use lists only when they make the work easier to follow

    line 122
  25. Distinctive:

    keep side issues out of the main path until they matter

    line 123
  26. Distinctive:

    Do not force checklist structure onto casual, creative, or voice-sensitive prose.

    line 126
  27. Distinctive:

    Use the shape that fits the writing.

    line 130
  28. Distinctive:

    Voice-sensitive or persuasive writing: keep the clarity gains without flattening the voice that does the job

    line 134
  29. Distinctive:

    Write plainly without overstating certainty or force.

    line 138
  30. Distinctive:

    keep real hedges when the fact is uncertain, conditional, estimated, or incomplete

    line 140
  31. Distinctive:

    remove fake hedges when they only add fog

    line 141
  32. Distinctive:

    keep passive voice only when the actor is unknown, irrelevant, tact-sensitive, or deliberately de-emphasized

    line 143
  33. Distinctive:

    Use these writing modes when they materially help.

    line 147
  34. Distinctive:

    If the user asks for strict STE-style review:

    line 154
  35. Distinctive:

    If you did not load the relevant rule text, do not cite rule numbers.

    line 159
  36. Distinctive:

    Do not combine these actions into one sentence.

    line 161
  37. Very specific:

    If the user asks for "plain English," "simple English," "clean this up," or a similar generic cleanup request without naming a mode, treat …

    line 163
  38. Distinctive:

    Treat sequence as behavior when the text tells the reader or agent to do one thing before another.

    line 167
  39. Distinctive:

    use a numbered list for 2 to 3 short ordered steps

    line 177
  40. Very specific:

    use ### Step 0 plus a checklist, then ### Step N: Name, for 4 or more ordered steps

    line 178
  41. Very specific:

    add Requires: when a step depends on an earlier step

    line 179
  42. Very specific:

    add Done when: when later work depends on a successful check

    line 180
  43. Distinctive:

    add a named failure route when a later step must wait for a passing check

    line 181
  44. Distinctive:

    put conditions before actions when that makes timing clearer

    line 183
  45. Distinctive:

    never leave ordered work in plain bullets

    line 185
  46. Distinctive:

    Default to a compact review unless the user asks for something more formal.

    line 193
  47. Distinctive:

    Do not prepend audit notes or explanation unless the user asked for them.

    line 205
  48. Distinctive:

    Do this first unless the user already specified the mode.

    line 229
  49. Distinctive:

    Write in plain, direct English that preserves the user's intended meaning, audience, tone, and explicit constraints.

    line 249
  50. Distinctive:

    Use one term for one concept.

    line 254
  51. Very specific:

    Do this when the reader must act.

    line 259
  52. Very specific:

    If the text contains ordered actions, load references/serial-instruction-guidance.md before you make the order explicit.

    line 260
  53. Distinctive:

    Do not deliver before Step 8 is complete.

    line 265
  54. Distinctive:

    If the self-check fails, return to the earliest affected step.

    line 266
  55. Distinctive:

    Do this before any other work when the rewrite workflow has 4 or more real actions.

    line 272
  56. Distinctive:

    Create a short checklist in your working state or reply and update it after each step.

    line 273
  57. Distinctive:

    Do this before any rewrite.

    line 290
  58. Distinctive:

    Do one safe rewrite pass that preserves the source job, meaning, tone, audience, and explicit constraints.

    line 300
  59. Distinctive:

    Remove wording that adds fog without adding meaning.

    line 305
  60. Very specific:

    If the source hides sequence, gates, or branch logic, load references/serial-instruction-guidance.md before you rewrite the sequence …

    line 310
  61. Distinctive:

    If sequence checks fail, return to Step 4.

    line 311
  62. Distinctive:

    Put meaning drift, ambiguity, hidden actions, obligation drift, and weak sequencing first.

    line 327
  63. Very specific:

    If the user asked for STE checking, load only the relevant part of references/ste-rules.md that you need.

    line 340
  64. Very specific:

    If the text contains ordered actions or weak sequencing cues, load references/serial-instruction-guidance.md before you judge whether the …

    line 341
  65. Distinctive:

    Use this priority order when rules compete:

    line 351
  66. Distinctive:

    use STE-like discipline as a clarity tool, not as a form override for creative or hybrid writing

    line 361
  67. Distinctive:

    remove fake hedges, but keep real uncertainty

    line 362
  68. Distinctive:

    use active voice by default, but keep passive when tact, uncertainty, or deliberate emphasis matters

    line 363
  69. Distinctive:

    Before you deliver, confirm:

    line 367
  70. Distinctive:

    When you apply this skill, optimize for disciplined English that stays precise, truthful, easy to scan, and easy to act on.

    line 386

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

English Manager

Use plain, direct English that is easy to read, easy to scan, and easy to act on.

Do not optimize for brevity alone. Preserve the user's intended meaning, audience, tone, and explicit constraints while making the text clearer, steadier, and harder to misread.

This skill uses one default writing system:

  • plain-language discipline for direct, concrete wording
  • STE-leaning structure for technical clarity and stable terminology
  • ADHD-friendly shaping for scanability and actionability when the text helps someone do something

Use these together. They are not separate modes.

Hard constraints

These outrank style preferences.

  • Preserve the user's meaning before you optimize wording.
  • Preserve the requested tone, audience fit, and explicit format constraints.
  • Preserve deliberate warmth, rhythm, humor, persuasion, or brand voice when the user wants them.
  • Preserve code, identifiers, commands, file paths, quoted errors, product names, API names, config keys, and legal text unless the user explicitly asks to rewrite them.
  • Keep real uncertainty, real nuance, and real obligation levels. Do not make text sound simpler by making it less true.
  • Do not claim official ASD-STE100 compliance. If the user asks for strict STE, say that full compliance depends on the official standard and dictionary.

Start here

Choose the smallest fitting path before you edit.

Step 1: Ask for the mode first

Do this first for drafting or rewriting tasks unless the user already specified the mode explicitly.

Offer these choices:

  • mode=default — local rewrite by default, plain and direct
  • mode=strict — stricter technical control, structural rewrite allowed when needed

If the user did not choose a mode, ask a short clarifying question instead of assuming. Done when: the rewrite mode is explicit, or the request is clearly audit-only.

Step 2: Choose the output mode

Requires: Step 1 is complete when the request needs a rewrite mode.

Choose one output mode before you edit:

  • Audit only — review the text without rewriting it unless the user asks.
  • Rewrite only — return cleaner final text directly.
  • Audit plus rewrite — give findings first, then the rewrite.

If the user asks for only the rewrite, return only the rewrite. Do not return audit notes unless the user asked for them. Done when: the output mode is explicit.

Step 3: Preserve the constraints

Requires: Step 2 is complete. Do this before you rewrite or restructure anything.

Extract and protect these first:

  • meaning
  • audience
  • tone
  • format
  • exact wording that must stay
  • quoted or technical text that must stay exact

If a style rule conflicts with an explicit user constraint, the constraint wins. Done when: the protected constraints are identified.

Step 4: Choose the scope through the mode

Requires: Step 3 is complete.

Let the mode set your default rewrite scope.

  • mode=default — do a local rewrite by default. Tighten or clarify the given text only. Preserve the source structure unless the user clearly asks for a fuller artifact or the current structure hides key meaning.
  • mode=strict — allow a structural rewrite when stronger control helps the text do its job. Reorganize, split, or relabel content when the current structure hides sequence, logic, safety, requirements, or operational clarity.

Do not treat mode=strict as permission to broaden the task casually. In both modes, keep the smallest change that solves the real problem unless the user explicitly asks for a broader rewrite. Done when: the allowed rewrite scope is clear.

Default writing method

Use this method unless the task clearly calls for a stricter overlay.

1. State the point early

Lead with the point, result, or next action.

  • In explanatory text, put the main fact early.
  • In operational text, put the next action early.
  • In support or error help, state what happened, why if known, and what to do next.

Do not add a preamble when the answer works better without one.

2. Use direct, concrete wording

Write the clearest accurate sentence you can.

  • prefer concrete actions and results over abstraction
  • use short familiar words when they keep the same meaning
  • remove filler, recap padding, and inflated phrasing
  • name the actor when the actor matters
  • prefer active voice when it improves clarity

If a simpler word would reduce accuracy, keep the precise word.

3. Keep one term for one concept

Pick one term for each repeated concept and keep it stable.

Do not rotate synonyms just to avoid repetition.

4. Keep the text easy to scan

Use light ADHD-friendly shaping by default:

  • keep sentences and paragraphs bounded
  • keep one main action or fact per sentence when possible
  • use lists only when they make the work easier to follow
  • keep side issues out of the main path until they matter
  • make the next action obvious when the reader needs to act

Do not force checklist structure onto casual, creative, or voice-sensitive prose.

5. Match the structure to the job

Use the shape that fits the writing.

  • Procedural or operational writing: imperative steps, condition before command, one action per step, warnings as explicit instructions
  • Descriptive writing: one main fact per sentence, related facts grouped together, no buried instructions in explanation paragraphs
  • Voice-sensitive or persuasive writing: keep the clarity gains without flattening the voice that does the job

6. Keep necessary nuance

Write plainly without overstating certainty or force.

  • keep real hedges when the fact is uncertain, conditional, estimated, or incomplete
  • remove fake hedges when they only add fog
  • preserve requirement strength, recommendation strength, permission, and capability accurately
  • keep passive voice only when the actor is unknown, irrelevant, tact-sensitive, or deliberately de-emphasized

Mode control

Use these writing modes when they materially help.

ModeWhenApply
mode=defaultMost requestsPlain-language discipline, stable terminology, scanable structure, action-first shaping when useful, and local rewrites by default
mode=strictThe user explicitly asks for STE, ASD-STE100-style writing, very strict plain language, highly controlled technical wording, or a stricter audit of technical proseDefault mode + stronger STE structure, stronger modality discipline, stronger procedural/descriptive separation, tighter terminology control, and structural rewrites when needed for clarity or control

If the user asks for strict STE-style review:

  1. Say that you can do a strict STE-leaning review.
  2. State that official ASD-STE100 compliance depends on the official standard and dictionary.
  3. Load only the relevant part of references/ste-rules.md that the request needs.
  4. Cite rule numbers only from the part of references/ste-rules.md that you actually loaded.
  5. If you did not load the relevant rule text, do not cite rule numbers.

Do not combine these actions into one sentence. Keep the order explicit.

If the user asks for "plain English," "simple English," "clean this up," or a similar generic cleanup request without naming a mode, treat that as a plain-language goal, not as implicit mode=strict.

Serial-order detection and handling

Treat sequence as behavior when the text tells the reader or agent to do one thing before another.

Detect and strengthen these cases:

  • explicit serial instructions — numbered steps, first/next/then/finally, before/after/until, requires, depends on, done when, return to
  • implied step ordering — one sentence hides multiple actions, one action depends on the output of another, or a warning implies a missing gate
  • sequencing cues in skill files — ask-for-mode first, choose output mode before delivery, preserve constraints before rewriting, load rule references before citing them, run self-check before delivery
  • sequencing cues in general prose — procedures, operational notes, support steps, onboarding text, prompts, and any paragraph where setup, action, validation, and delivery are mixed together

When order matters:

  • make the sequence explicit
  • use a numbered list for 2 to 3 short ordered steps
  • use ### Step 0 plus a checklist, then ### Step N: Name, for 4 or more ordered steps
  • add Requires: when a step depends on an earlier step
  • add Done when: when later work depends on a successful check
  • add a named failure route when a later step must wait for a passing check
  • split do X and then Y into separate steps when that improves compliance
  • put conditions before actions when that makes timing clearer
  • replace emphasis-only warnings with enforceable gates only when a later action already depends on an earlier check
  • never leave ordered work in plain bullets

Load references/serial-instruction-guidance.md before you rewrite or audit any text with real workflow order, gating, branching, or validation loops. Keep SKILL.md operational. Use the reference for deeper detection logic, structure rules, and edge cases.

Output rules

Audit only

Default to a compact review unless the user asks for something more formal.

Use this shape:

  1. Summary — 1 to 3 sentences on the main clarity, tone, or actionability issues
  2. Highest-risk issues first — especially meaning drift, ambiguity, hidden actions, obligation drift, or broken structure
  3. Targeted findings — source text, risk, and a brief note only when it helps
  4. Optional full rewrite — include it only if the user asked for one or the passage has repeated issues

Rewrite only

Return only the rewrite when the user asks for only the rewrite.

Do not prepend audit notes or explanation unless the user asked for them.

Audit plus rewrite

Give the findings first, then the rewrite.

Reference loading map

Load references only when they materially help.

  • references/serial-instruction-guidance.md — ordered instructions, implied sequencing, gating, branching, validation loops, and when a paragraph should become explicit steps
  • references/substitutions.md — wording cleanup, filler removal, consistency sets, modality checks
  • references/checklist.md — final verification pass or detailed audit support
  • references/ste-rules.md — technical, procedural, instructional, or explicit STE requests; also for mode=strict
  • references/adhd-patterns.md — stronger action-oriented shaping when the reader needs execution help, low-friction next steps, or ADHD-friendly formatting beyond the default
  • references/use-cases.md — adapt the core method to docs, prompts, support replies, incident notes, UI copy, or voice-sensitive writing
  • references/rfc-2119.md — only for normative or behavior-defining text such as policy, requirements, interface contracts, governance, or procedures where informal severity labels hide true obligation
  • references/examples.md — anchor patterns when the request is ambiguous or the text mixes clarity goals with voice-sensitive constraints

Delivery workflow

For drafting from scratch

Step 1: Ask for the mode

Do this first unless the user already specified the mode. Done when: the rewrite mode is explicit, or the request is truly audit-only.

Step 2: Choose the output mode

Requires: Step 1 is complete when the request needs a rewrite mode. Choose Audit only, Rewrite only, or Audit plus rewrite before you draft. Done when: the output mode is explicit.

Step 3: Extract the constraints

Requires: Steps 1 and 2 are complete. Identify the meaning, audience, tone, format, and exact wording that must stay fixed before you draft. Done when: the protected constraints are identified.

Step 4: Apply the mode

Requires: Step 3 is complete. Let mode=default or mode=strict set the default scope. Done when: the allowed rewrite scope is clear.

Step 5: Draft in direct English

Requires: Steps 1 to 4 are complete. Write in plain, direct English that preserves the user's intended meaning, audience, tone, and explicit constraints. Done when: the draft does the same job as the source.

Step 6: Keep repeated terms stable

Requires: Step 5 is complete. Use one term for one concept. Do not rotate synonyms for style. Done when: repeated concepts use stable terms.

Step 7: Make the action path easy to scan

Requires: Steps 5 and 6 are complete. Do this when the reader must act. If the text contains ordered actions, load references/serial-instruction-guidance.md before you make the order explicit. Done when: ordered actions are visible as ordered actions.

Step 8: Run the self-check before delivery

Requires: Steps 1 to 7 are complete. Do not deliver before Step 8 is complete. If the self-check fails, return to the earliest affected step. Done when: the self-check passes.

For revising existing text

Step 0: Track progress

Do this before any other work when the rewrite workflow has 4 or more real actions. Create a short checklist in your working state or reply and update it after each step.

  • Step 1: Ask for the mode
  • Step 2: Preserve the user's meaning and constraints
  • Step 3: Apply the mode
  • Step 4: Tighten the wording with the smallest safe change
  • Step 5: Remove filler, stale phrasing, and avoidable abstraction
  • Step 6: Split overloaded sentences or restructure only when substitution alone will not work
  • Step 7: Recheck pronouns, modality, and untouchables
  • Step 8: Run the self-check before delivery

Step 1: Ask for the mode

Do this first unless the user already specified the mode. Done when: the rewrite mode is explicit, or the request is truly audit-only.

Step 2: Preserve the user's meaning and constraints

Requires: Step 1 is complete. Do this before any rewrite. Done when: meaning, audience, tone, format, and untouchables are identified.

Step 3: Apply the mode

Requires: Steps 1 and 2 are complete. Let mode=default or mode=strict set the default scope. Done when: the allowed rewrite scope is clear.

Step 4: Tighten the wording with the smallest safe change

Requires: Steps 1 to 3 are complete. Do one safe rewrite pass that preserves the source job, meaning, tone, audience, and explicit constraints. Done when: the draft is clearer without changing the job.

Step 5: Remove filler, stale phrasing, and avoidable abstraction

Requires: Step 4 is complete. Remove wording that adds fog without adding meaning. Done when: the remaining wording is carrying meaning or control.

Step 6: Split overloaded sentences or restructure only when substitution alone will not work

Requires: Steps 4 and 5 are complete. If the source hides sequence, gates, or branch logic, load references/serial-instruction-guidance.md before you rewrite the sequence explicitly. If sequence checks fail, return to Step 4. Done when: the workflow cannot be read as unordered advice.

Step 7: Recheck pronouns, modality, and untouchables

Requires: Steps 4 to 6 are complete. Done when: referents are clear and obligation strength still matches the source.

Step 8: Run the self-check before delivery

Requires: Steps 1 to 7 are complete. Do not deliver before Step 8 is complete. If the self-check fails, return to the earliest affected step. Done when: the self-check passes.

For checking text instead of rewriting it

Step 1: Identify the highest-risk issues first

Put meaning drift, ambiguity, hidden actions, obligation drift, and weak sequencing first. Done when: the highest-risk issues are ranked.

Step 2: Keep the review proportional to the request

Requires: Step 1 is complete. Done when: the audit depth matches the request.

Step 3: Use a stricter, rule-based audit format only when the user asks for it or the text is high-consequence

Requires: Steps 1 and 2 are complete. Done when: the audit shape matches the risk and request.

Step 4: Load the right references before citing them

Requires: Step 3 is complete. If the user asked for STE checking, load only the relevant part of references/ste-rules.md that you need. Do not invent rule numbers. If the text contains ordered actions or weak sequencing cues, load references/serial-instruction-guidance.md before you judge whether the sequence is clear enough. Done when: every cited rule comes from a loaded reference.

Step 5: Run the self-check before delivery

Requires: Steps 1 to 4 are complete. Do not deliver before Step 5 is complete. Done when: the self-check passes.

Conflict resolution

Use this priority order when rules compete:

  1. User meaning, audience, tone, and explicit constraints
  2. Untouchables and required exact wording
  3. Clarity and actionability
  4. Technical-writing discipline
  5. Brevity

Specific resolutions:

  • preserve warmth or voice when the text depends on relationship tone, persuasion, rhythm, or brand fit
  • use STE-like discipline as a clarity tool, not as a form override for creative or hybrid writing
  • remove fake hedges, but keep real uncertainty
  • use active voice by default, but keep passive when tact, uncertainty, or deliberate emphasis matters

Required self-check before delivery

Before you deliver, confirm:

  1. The rewrite still does the same job for the same audience.
  2. Key terms stayed stable.
  3. Obligation, permission, capability, and uncertainty did not drift.
  4. Untouchables stayed exact.
  5. Any explicit or implied ordered instructions are still visible as ordered instructions.
  6. Any required gate, dependency, or validation step still blocks the later step clearly.
  7. The final answer matches the requested output mode.
  8. The final answer matches the requested rewrite mode.
  9. Any remaining qualitative wording still has a clear operational role and does not act as a hidden gate.

For a deeper mechanical pass, load references/checklist.md.

Limits

This skill improves clarity and execution-readiness. It does not replace subject-matter accuracy, legal review, brand review, or official ASD-STE100 certification.

It is also a writing skill, not a fact-checking or policy-setting skill. Improve the prose without inventing new requirements, commitments, or product behavior.

When you apply this skill, optimize for disciplined English that stays precise, truthful, easy to scan, and easy to act on.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.