tamdogood/builder-essential-skills

orwell-writing

Use when an agent is asked to draft, rewrite, edit, review, polish, copyedit, simplify, humanize, or create written prose, including creative writing, essays, posts, scripts, speeches, emails, documentation, product copy, and other style-sensitive text.

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/tamdogood/builder-essential-skills --skill orwell-writing

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

Orwell Writing

Overview

Use Orwell's rules and ASD-STE100 Simplified Technical English (STE) as practical filters for clear, direct, and honest prose. Use STE by default for technical, instructional, business, and product prose. Apply the rules to both drafting and revision, but do not erase deliberate voice, character, rhythm, humor, or genre when the user clearly wants them.

STE has writing rules and a controlled dictionary. Use an approved word with its approved meaning when the dictionary is available. Do not claim strict STE conformance without checking the current ASD-STE100 issue and dictionary.

Core Rules

Remember these rules from "Politics and the English Language":

  1. Never use a metaphor, simile, or other figure of speech which you are used to seeing in print.
  2. Never use a long word where a short one will do.
  3. If it is possible to cut a word out, always cut it out.
  4. Never use the passive where you can use the active.
  5. Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent.
  6. Break any of these rules sooner than say anything outright barbarous.

ASD-STE100 baseline

For technical and instructional prose:

  1. Use short sentences. Put one main action or statement in each sentence.
  2. Use a clear subject and an active verb. Name the actor when the actor matters.
  3. Use the same term for the same thing. Do not change a term only to avoid repetition.
  4. Use familiar words with one precise meaning. Avoid idioms, slang, figurative language, and vague verbs.
  5. Use a specific technical term when it is necessary for accuracy. Define it or link to its definition.
  6. Keep noun groups short. Use prepositions to show relationships between terms.
  7. Write procedures as direct instructions. State the condition, action, and expected result.
  8. Use positive instructions when they are clear. State what the reader must do.
  9. Use consistent American English spelling unless the user's style guide requires another variety.
  10. Preserve code, commands, identifiers, product names, legal text, and required quotations. Do not simplify them silently.

When strict STE is not possible, keep the text clear and mark the terms or passages that need a domain-specific exception.

Workflow

When writing from scratch:

  1. Identify the audience, purpose, and promised tone from the user's request.
  2. Draft in concrete, direct English.
  3. Remove stock phrases, dead metaphors, filler, pompous diction, needless abstraction, and avoidable jargon.
  4. Prefer active verbs and clear subjects unless passive voice better serves emphasis, tact, suspense, or technical accuracy.
  5. Keep necessary nuance; do not make prose crude, false, or flat just to make it short.
  6. Apply the ASD-STE100 baseline. Check terms, sentence structure, instructions, and technical exceptions.

When revising existing text:

  1. Preserve the user's meaning and any explicit tone or format constraints.
  2. Cut words, clauses, and sentences that do no work.
  3. Replace stale figures of speech with plain phrasing or a fresh, specific image.
  4. Replace long, foreign, scientific, or jargon terms with everyday English when accuracy permits.
  5. Convert passive constructions to active ones when the actor matters and is known.
  6. Flag any remaining jargon, passive voice, or ornate phrasing that is necessary rather than silently removing important precision.
  7. Run a final STE pass. Check that each technical term is consistent, each instruction states the required action, and each exception is intentional.

Creative Writing

For fiction, poetry, memoir, scripts, and lyrical prose, treat STE as a clarity aid, not a requirement that overrides the user's form. Keep intentional ambiguity, cadence, dialogue style, imagery, and character voice when they create a real effect. Remove only language that feels inherited, inflated, evasive, or lazy. Use strict STE when the user explicitly requests it, and note when that request conflicts with a creative effect.

Powiązane zadania

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
tamdogood
Społeczność

async-learning-teacher

Transform saved links, papers, articles, posts, videos, and reference collections into approachable AI teaching artifacts for later study. Use when a user wants to queue learning material, create a readable explanation from a source, teach a paper or post step by step, or run an interactive tutor that validates understanding over multiple sessions.

instalacje
1
GitHub Stars
225
Aktualizacja
16 sie
tamdogood
Społeczność

code-standards

Apply a disciplined engineering workflow to any code change. Use whenever implementing a feature, fixing a bug, or refactoring — before writing code, not after. Walks orient → baseline → smallest change → test → verify → self-review, and enforces language-agnostic hard gates (don't mass-reformat, keep the linter and type-checker clean, keep the build and tests green, make interface changes additive, protect security invariants).

instalacje
1
GitHub Stars
225
Aktualizacja
16 sie
tamdogood
Społeczność

create-skill

Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork, README links, discovery metadata, and validation. Use when the user asks to create a new skill, add a skill to this collection, turn a workflow into a reusable skill, or make a skill's documentation and artwork consistent with the repository.

instalacje
1
GitHub Stars
225
Aktualizacja
16 sie
tamdogood
Społeczność

map-the-landscape

Map the big picture around a topic or software repository by identifying its boundaries, layers, actors, components, relationships, flows, history, fault lines, and open questions, then explain how the pieces fit together and where to look next. Use when a user asks to understand a whole field, domain, technology, ecosystem, industry, codebase, architecture, unfamiliar repo, or phrases such as "give me the big picture", "map the landscape", "how does this all fit together?", "help me get oriente

instalacje
1
GitHub Stars
225
Aktualizacja
16 sie