agentleFS
wellwelwelwellwelwel/lagune/.claude/skills/writer/SKILL.md

writer

Skill216 starsChanged 17 days agoApache-2.0View on GitHub

Authoritative reference for writing the project's prose. Use before writing, editing, or translating any document, command text, comment, or user-facing message.

13 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 7 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 11 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Avoid em dashes or semicolons where they are not grammatically necessary.

    line 17
  2. Distinctive:

    When the document already exists, read it and study its existing style before you edit, then write in that same voice.

    line 19
  3. Distinctive:

    Avoid writing a file path or pasting a code snippet into a document.

    line 20
  4. Distinctive:

    Remove before you add: before editing existing text, first remove everything that is no longer valid, then adapt and update what changed, …

    line 26
  5. Very specific:

    Use straight quotes and apostrophes (' and "), never their curly forms, and avoid any character a standard keyboard lacks.

    line 30
  6. Distinctive:

    When the source is in another language, translate it into natural American English that reads as though written in English from the start, …

    line 35
  7. Distinctive:

    Avoid literal or stiff translations.

    line 37
  8. Distinctive:

    After writing, run this checklist:

    line 43

“Common” is measured: kept by at least 6 in 10 of the 11 edited versions of this file we could read. “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

Text writing

This skill is the specialized, authoritative description of how the project's prose is written: the language and style conventions, the plain-language rule, and the reconcile discipline that keeps documents living. Consult it before writing or editing any document, command text, comment, or user-facing message.

Language and style

  • Avoid em dashes or semicolons where they are not grammatically necessary. Where one would go, for example, use the mark the sentence actually calls for, usually a comma, colon, or parentheses.
    • Write in complete sentences, each with a beginning, middle, and end, instead of chopping one thought into fragments. A semicolon, an em dash, or a period used to cut a sentence short is the same habit wearing different punctuation, so the fix is to compose the sentence, not to swap the mark that split it.
  • When the document already exists, read it and study its existing style before you edit, then write in that same voice. When it is entirely new, read a similar or equivalent file to learn the pattern first.
  • Avoid writing a file path or pasting a code snippet into a document. A flat document does not track the source, so a moved file or a changed snippet leaves a stale, broken reference.

Rules

  • All project content is written in English (docs, code, comments, command text, user messages), regardless of the language used in chat.
  • Less is more: cut anything that adds words without meaning: throat-clearing openers that delay the point, reinforcement triads where one word does the job, framing sentences that announce content instead of being it, and padding that stretches a thought to look thorough. Stop once the point lands.
  • Remove before you add: before editing existing text, first remove everything that is no longer valid, then adapt and update what changed, and add new text only when it is genuinely needed.
  • Redundancy is forbidden: judged across the whole document, not one sentence at a time. A sentence clean on its own still counts as redundant when its meaning already lives elsewhere. Say each thing once, in the one place it belongs.
  • Describe intent, not implementation: do not restate logic, cite specific variable or method names, or re-explain how something is built. A rename or a refactor silently turns that prose false, so say what it does and why, and let the code stay the single source of how.
  • Never break lines by hand in the middle of the prose: line width, wrapping, and formatting are Prettier's job, not yours.
  • Use straight quotes and apostrophes (' and "), never their curly forms, and avoid any character a standard keyboard lacks.
  • Reconcile, never append. When updating existing text, reconcile it against the current truth instead of layering new content on top of the old. Re-check each existing statement: keep what still holds, rewrite what changed, and remove what no longer applies. Write genuinely new content only for what is actually new. The result must read as a clean statement of the present, not a record of how it got there. The past does not matter for its own sake. Never let a document grow by accumulation alone.

Translation

When the source is in another language, translate it into natural American English that reads as though written in English from the start, as fluent as the original.

  • Avoid literal or stiff translations. ❌ "The name of the project of the organization" is a calque, ✅ "The project name in the organization" is English.
  • Grasp the original's tone, idiom, and intent before you translate, then reproduce those in English.
  • Where the source is unclear or ambiguous, ask for more context before translating instead of guessing.

Review

After writing, run this checklist:

  • Remove every redundancy, across the whole document.
  • Where the writing runs long-winded or roundabout, tighten it to be direct, without sacrificing clarity.
  • Confirm every rule and recommendation in this skill is followed.

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.