wellwelwel/lagune / .claude/skills/writer
writer
VerifiedAuthoritative reference for writing the project's prose. Use before writing, editing, or translating any document, command text, comment, or user-facing message.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
SKILL.md
View on GitHub---
name: writer
description: Authoritative reference for writing the project's prose. Use before writing, editing, or translating any document, command text, comment, or user-facing message.
user-invocable: true
metadata:
author: Weslley Araújo
version: '1.0.0'
source: https://github.com/wellwelwel/skills
---
# 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |