Agent skill
Society in Silico Writing Style
Auto-activates when writing or editing prose in the manuscript/ directory. Applies Max Ghenis's direct, active voice, data-driven writing style.
Install this agent skill to your Project
npx add-skill https://github.com/MaxGhenis/society-in-silico/tree/main/skills/writing-style
SKILL.md
Writing Style for Society in Silico
This skill activates when working on manuscript content. Apply these principles automatically.
The Voice
Direct: State conclusions first, then support them.
- Not: "It's worth considering that perhaps..."
- Yes: "The model shows X. Here's why."
Active: Subject-verb-object.
- Not: "The reform was estimated by CBO to reduce..."
- Yes: "CBO estimated the reform would reduce..."
Neutral: Present tradeoffs, not advocacy.
- Not: "This excellent policy would help millions"
- Yes: "This policy would increase benefits for 3.2 million households while increasing federal costs by $40 billion"
Quantified: Numbers over adjectives.
- Not: "significantly increased"
- Yes: "increased 47%"
Quick Reference
Always Avoid
- "It should be noted that..."
- "Interestingly..."
- "It is important to..."
- "One might argue..."
- Passive voice (unless strategic)
- Adverbs ending in -ly
- "Very", "really", "quite", "somewhat"
Prefer
- Short sentences
- Concrete nouns
- Active verbs
- Specific numbers
- Direct statements
Acceptable (This is a Book, Not a Blog)
- Narrative storytelling
- Personal anecdotes when relevant
- Building arguments across paragraphs
- Metaphors that illuminate concepts
- Occasional longer sentences for rhythm
When Writing New Content
- Lead with the point
- Support with evidence
- Acknowledge limitations honestly
- Move forward
When Editing
Ask of each sentence:
- Is this active voice?
- Can I cut words without losing meaning?
- Is there a vague word I can replace with a number?
- Does this advance the argument?
Examples
Before
"It is perhaps worth noting that microsimulation has been increasingly used by various governmental bodies over the past several decades, with some degree of success in predicting policy outcomes."
After
"Governments have used microsimulation since the 1960s. CBO's budget projections average 1.2% error."
Before
"The really impressive thing about PolicyEngine is that it has managed to quite successfully democratize access to policy analysis tools."
After
"PolicyEngine gives anyone access to the same tax-benefit calculations that CBO uses. 50,000 people ran simulations last year."
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
Society in Silico Book Structure
Auto-activates when navigating or organizing the manuscript. Knows the book's structure, chapter organization, and file conventions.
Brand Name Oracle
Use this skill when the user wants to forecast a brand name's success. Checks domain availability, social handles, trademarks, pronunciation, international meanings, similar companies, and AI perception prophecy.
Brand Name Comparison
Use this skill when the user wants to compare multiple brand name fates side-by-side to divine which is destined for success.
Brand Name Divination
Use this skill when the user wants to divine or generate brand name ideas for a company, product, or project.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
Didn't find tool you were looking for?