writing-core
Skill1 starsChanged 35 days agoMITView on GitHub
Shared rules for all non-fiction writing, including a 12-style text menu asked at the start of each task. Load alongside academic-report-writer, work-report-writer or script-writer, and use alone for emails, cover letters, applications, posts, bios. Not for fiction.
5 other projects use a version of this.
Adopted by
Most recently taken up by
- ldaume/agentic-engineering-harnesstheir own version, first seen Nov 8, 2026
- SgtPooki/skillstheir own version, first seen Oct 11, 2026
- Norman-bury/articlewriting-skilltheir own version, first seen Oct 8, 2026
- Norman-bury/research-writing-skilltheir own version, first seen Oct 8, 2026
- aidless/research-writing-skilltheir own version, first seen Oct 4, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- Norman-bury/research-writing-skill★ 3.4ksame name
- Norman-bury/articlewriting-skill★ 3.4ksame name
- ldaume/agentic-engineering-harness★ 3same name
- SgtPooki/skills★ 1same name
- aidless/research-writing-skill★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository3 other files it gives its agents.
- academic-report-writerSkill
- script-writerSkill
- work-report-writerSkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 11 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈11
Distinctive · estimate
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
- Distinctive: line 13
Not for fiction, stories, poems, or song lyrics.
- Distinctive: line 33
Put the style question in the same message as any intake questions.
- Distinctive: line 45
If he answers the other questions but skips the style, use the first recommended style and say so in one line.
- Distinctive: line 66
Keep the chosen style for the rest of that task.
- Distinctive: line 89
No em dashes. Use a period, comma, colon, or "and".
- Distinctive: line 90
Avoid: delve, tapestry, landscape (figurative), realm, pivotal, underscore, multifaceted, seamless, game-changer, robust (unless …
- Distinctive: line 91
Do not group everything in threes.
- Distinctive: line 92
No closing paragraph that repeats every earlier point.
- Distinctive: line 96
Never invent data, results, quotes, experiences, feelings, names, references, page numbers, DOIs, prices, or dates.
- Distinctive: line 103
When tools allow (web search, code on his files), verify facts and compute numbers instead of estimating.
- Very specific: line 124
Put deliverable text in fenced text code blocks so the copy button gives clean text.
- Distinctive: line 125
No markdown inside blocks.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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.
Files
Writing Core
The shared rules behind the user's writing skills. Two ways this skill is used:
- Alongside a family skill. academic-report-writer (university work), work-report-writer (reports at work), and script-writer (videos, lectures, workshops) each tell Claude to load this skill first. The family skill then adds its own structure, output format, and trigger.
- Alone, for any other non-fiction writing: emails, cover letters, applications, motivation letters, LinkedIn or social posts, bios, abstracts, short articles, README intros.
Not for fiction, stories, poems, or song lyrics. If the request is one of those, do not apply these rules.
Why these rules exist
The rules come from StoryScope (Russell, Rajendhran, Pham, Iyyer and Wieting, COLM 2026, arXiv:2604.03136). The paper compared 10,272 human short stories with 51,336 stories from five LLMs (Claude, GPT, Gemini, DeepSeek, Kimi) written from the same prompts. With style features removed, narrative choices alone separated human from AI writing at 93.2% macro-F1.
Three lessons drive everything below:
- AI defaults converge. All five models landed in one tight region. Human work was more spread out and rarer (mean rarity percentile 0.71 vs 0.49). The same prompt gives everyone roughly the same generic text. Originality comes from inputs only the user has: his data, decisions, experience, sources, context, and opinion.
- Surface edits do not change structure. Removing cliches and purple prose only moved detection from 95.5% to 93.9%. Swapping synonyms does not make text his. Changing decisions does: which evidence, what order, what conclusion, what failed.
- The AI defaults are also weak writing. Fixing them improves the text no matter who drafted it.
Caveat: the paper studied fiction of about 5,000 words. Applying it to non-fiction is an analogy, not a measured result. Never present its numbers as facts about other kinds of writing.
Rule 0: Ask for the text style (every new task)
At the start of every new writing task, ask him which text style he wants and show him the full menu below. A new task means a new piece of text: a new report, section, email, script, post, or letter. Follow-up edits on the same piece keep the style already chosen.
How to ask
- Put the style question in the same message as any intake questions. It does not count toward the 3-question intake limit.
- Show all 12 styles as a numbered list, one line each, exactly as named below. Mark the 2 or 3 styles that best fit this task with "(recommended)". The family skills say which ones.
- Tell him he can pick one number, or combine two (for example "2 + 4"). For style 12, ask him to paste a sample of his writing.
- Show the list as plain text in the chat. A multiple-choice tool with only a few options cannot hold all 12, so do not use one for this question.
When not to ask
- He already named a style or tone in the request ("formal", "casual", "like my last email"). Map it to the closest style and say which one in one short line.
- He says "same style", "as before", or "you choose". Use the last style from this conversation, or the first recommended style for the task.
- The task produces no text for him to use: explaining a concept to him, formatting citations, or answering a question.
- The session runs unattended or on a schedule. Use the first recommended style and state it at the top.
If he answers the other questions but skips the style, use the first recommended style and say so in one line. Do not ask again for the same task.
The text style menu
| # | Style | What it changes | Fits best |
| 1 | Plain and clear | Common words, short to medium sentences, active voice. The default. | Anything |
| 2 | Formal academic | Impersonal or third person, no contractions, precise hedging ("suggests", "is consistent with"), field terms defined once | Reports, essays, lit reviews, lab reports |
| 3 | Professional | Direct and polite, answer first, no slang, light warmth | Work reports, emails to managers or clients |
| 4 | Technical | Exact terms, versions, units, parameters, and names. Few adjectives. Dense but precise | CS project docs, method sections, READMEs |
| 5 | Conversational | Friendly, contractions, speaks to "you", short sentences, simple questions to the reader | Posts, videos, informal emails |
| 6 | Persuasive | Claim first, strongest evidence next, the main objection answered, a clear ask at the end | Proposals, cover letters, pitches |
| 7 | Concise executive | Shortest possible form. Numbers and decisions first. Bullets where the format allows | Status updates, memos, summaries |
| 8 | Reflective personal | First person, named feelings tied to specific moments, what he learned and would change | Reflections, personal statements, motivation letters |
| 9 | Teaching | Step by step, terms defined before use, example before the general rule, short checks for understanding | Lectures, tutorials, workshops, explainers |
| 10 | Storytelling | Opens with a hook, uses his real story or example, builds tension, then the payoff | Videos, talks, LinkedIn posts, introductions |
| 11 | Simple English | Very common words, one idea per sentence, no idioms. For readers who are not native speakers | Instructions, notices, multilingual audiences |
| 12 | Match my writing | Mirrors sentence length, vocabulary, and tone from a sample he pastes | Anything he wants to sound exactly like him |
What no style changes: the rules below still apply in every style. No invented content, markers for gaps, no em dashes, no avoid-list phrases, and no moral endings. Storytelling (10) and Reflective (8) use only his real stories and feelings. If he has not given any, ask or use [YOUR INPUT: ...]. Persuasive (6) never overstates the evidence.
Keep the chosen style for the rest of that task. A combination like "2 + 4" means: the register of the first, the precision of the second.
Rule 1: His inputs first
Before drafting anything longer than a few sentences, check what he gave you: data, results, notes, experience, opinions, sources, constraints, audience. If something essential is missing, ask once, at most 3 questions in one message. If he wants a draft anyway, draft it and put markers where his material belongs. Never fill gaps with invented content.
For anything over about 150 words, sketch a skeleton first (internally for short pieces, shown to him for long ones): main point, evidence, his decisions, what did not work or the limits, one real tension or open question. StoryScope built structured templates before comparing stories because templates force reasoning about content instead of wording. The same works for writing.
Rule 2: Avoid the AI defaults
| AI default (paper evidence) | What it looks like in non-fiction | Do instead |
| Over-explains the theme (narrator states it 77% vs 52%) | Every paragraph ends with "This highlights the importance of X"; conclusions lecture | State the point once, early. Let evidence carry it. Cut restating closers. |
| Vague allusions (72% vs 50%); humans name works nearly twice as often (47% vs 24%) | "Studies show", "experts agree", "various tools" | Name the source, person, tool and version, dataset, number, place, date. |
| Tidy single track (no subplots 79% vs 57%); humans more ambivalent (59% vs 38%) | Everything worked, one explanation, every question resolved | Include real failures, trade-offs, alternatives, limits, one open question. Only real ones from his material. |
| Emotion through the body (81% vs 38%); humans name feelings (29% vs 8%) | Metaphor and decoration: "navigating the landscape", "a knot in my stomach" | Plain literal statements. Name feelings directly and tie them to a specific moment. |
| Rarely revisits earlier parts (recontextualization 3.28 vs 2.95 for humans) | Linear list of points that never connect back | Link a later point back to an earlier assumption or decision and say what changed. |
| Claude's own fingerprint: restraint, epilogues, reverent toward tradition (62% vs 39 to 56%) | Agrees with every source, hedged neutral stance, "As AI continues to evolve..." endings | Take a defensible position. Critique something on specific grounds. End on the finding or next step. |
Rule 3: Surface cleanup
Cheap to fix and matters less than Rule 2, but it reads as filler:
- No em dashes. Use a period, comma, colon, or "and".
- Avoid: delve, tapestry, landscape (figurative), realm, pivotal, underscore, multifaceted, seamless, game-changer, robust (unless technical), "in today's fast-paced world", "it is important to note", "plays a crucial role", "serves as a testament", "not only X but also Y" used repeatedly.
- Do not group everything in threes. Vary sentence length.
- No closing paragraph that repeats every earlier point.
Rule 4: Never invent
Never invent data, results, quotes, experiences, feelings, names, references, page numbers, DOIs, prices, or dates. Use these markers instead. All family skills use the same markers, in capitals and square brackets so they cannot be missed before he sends or submits anything:
[YOUR INPUT: ...]his data, decision, opinion, example, or experience[CITE: ...]a claim that needs a source; say what kind[VERIFY: ...]a detail you are unsure of (date, version, number, name, reference field)[FIGURE: ...]a suggested figure, chart, or table and what it should show
When tools allow (web search, code on his files), verify facts and compute numbers instead of estimating.
Rule 5: Voice
Write in the text style he picked under Rule 0. Within that style, match his voice. If he shares past writing, mirror its sentence length and vocabulary. With no style chosen, use style 1: clear, plain English, common words over rare ones, short to medium sentences, active voice. Text he sends should sound like him and be something he can explain and defend. Reply in the language he writes in. Write the deliverable in the language it will be used in.
Rule 6: Self-check before sending
- Is each point stated once?
- Does every factual claim have a named source, his data, or a marker?
- Is there at least one real limit, failure, or trade-off where the format allows?
- Anything invented? Replace it with a marker.
- Any phrase from the avoid list, decoration, or em dash?
- Does the ending give a specific point or next step, not a moral or epilogue?
- Where are his decisions and inputs? If none, add markers or ask.
- Does the text match the style he picked, from the first line to the last?
Output basics
He usually pastes into Word, email, or another app, so markdown symbols would paste literally.
- Put deliverable text in fenced
textcode blocks so the copy button gives clean text. Label each block above the fence. - No markdown inside blocks. After a block, note any formatting to apply (headings, bold, italics, bullets).
- Family skills may override this with their own format.
Quick notes for standalone use
Recommended styles when this skill is used alone: email 3 or 5, cover letter or application 6 or 3, motivation or personal statement 8, LinkedIn or social post 5 or 10, bio 3 or 1.
- Email: subject line that states the topic or ask. The ask or main point in the first two lines. One topic per email. Clear next step with a date if relevant.
- Cover letter or application: match evidence to the role's stated requirements, one specific example per requirement, real numbers from his work. No generic adjectives ("passionate", "hard-working") without proof. Ask for the job post and his CV if missing.
- Motivation or personal statement: concrete moments from his experience, what he did and learned, why this program specifically. Never invent experiences.
- LinkedIn or social post: first line states the point or result. One idea per post. Specific details over claims. No hashtag walls.
- Bio: third or first person as asked, current role first, two or three specific achievements, no superlatives.
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
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.

