Skip to main content
skill CX Codex

scott-adams — Claude Code skill: editing and installation

This skill helps trim prose, sharpen opening lines, and keep sentences short. Use it to revise writing with Scott Adams' business-writing method.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add surendranb/writing-skills --skill scott-adams -a claude-code
Open on GitHub

What scott-adams does

The skill guides the agent through a pass on the text: open with a line that raises a question, remove words that add no meaning, shorten sentences, and put the actor before the action. It favors precise nouns and verbs over adverbs, and discourages sentences with nested clauses.

During review, the agent checks whether the opening creates interest, whether intensifiers and passive constructions can go, and whether each sentence carries one idea. It requires a standard Markdown parser and agent context. Without those, this review method has no stated basis for working.

What it helps with

  • cut words that do not change a sentence's meaning
  • split long sentences into single ideas
  • replace vague verbs with precise ones
  • write an opening that makes readers want the next sentence
  • reorder sentences to put the actor before the action

Example prompts for the agent

  • Edit this passage with scott-adams: shorten the sentences and remove words that add no meaning.
  • Rewrite the opening so it raises a question without giving away the answer.
  • Find passive constructions and tangled sentences, then suggest direct rewrites.

How to install scott-adams

1Skills CLI (Vercel)

npx skills add surendranb/writing-skills --skill scott-adams -a claude-code

2Manually: put the files in place

~/.claude/skills/scott-adams/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/scott-adams/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about scott-adams

How do I install scott-adams in Claude Code?

Run npx skills add surendranb/writing-skills --skill scott-adams -a claude-code. The skill file is at ~/.claude/skills/scott-adams/SKILL.md.

What does the scott-adams skill do?

It helps revise prose by trimming filler, shortening sentences, and making the actor clear before the action. It also focuses on an opening line that gives readers a reason to continue.

What does scott-adams need to work?

It requires a standard Markdown parser and agent context.

Source text

SKILL.md · MIT
---
name: scott-adams
description: Use when the user wants to simplify prose, prune extra words, craft high-curiosity opening hooks, write punchy short sentences, and structure ideas for maximum human brain comprehension based on Scott Adams' famous business writing method.
compatibility: Requires standard Markdown parser and agent context
---

# Scott Adams' Business Writing Method

Simplicity is persuasion. Prune unnecessary words, hook readers instantly, and write short sentences matched to how human brains process ideas.

## The core rule

**Simplicity equals persuasion. Cut extra words, write a high-curiosity opening hook, keep sentences short, and put the actor before the action.**

Workflow: `craft a high-curiosity hook` → `prune all filler and adverbs` → `write short sentences (one thought per sentence)` → `order subject before action`.

## Mechanics

1. **Prune extra words.** Delete filler words (e.g., "very", "really", "quite"). If removing a word doesn't change the meaning, delete it.
2. **Humor equals precise word choice.** Use specific, punchy verbs and nouns instead of generic verbs modified by adverbs (e.g., "swill" instead of "drink a lot").
3. **The curiosity hook.** The first sentence creates an information gap: the reader knows something valuable is coming but cannot see it, so they must read on to close the gap. Adams' own opener did this: "I went from being a bad writer to a good writer after taking a one-day course in 'business writing.'" (Which course? What did it teach?) Build the gap by promising a payoff, stating a surprising claim, or ending the sentence just before the answer. Adams rewrote that first sentence "a dozen times" until it made the reader curious. Test: if the reader can stop after sentence one, it is not a hook.
4. **One thought per sentence.** Keep sentences short. Never bundle multiple complex ideas into a single sentence. Readers comprehend simpler chunks faster.
5. **Actor before action.** Sequence sentences so the subject (actor) appears before the verb (action). Human brains process "the boy hit the ball" faster than "the ball was hit by the boy."
6. **No complex nesting.** Avoid subordinate clauses that delay the core subject-verb relationship.

## Verify

- First sentence opens an information gap — reader cannot stop after it
- Zero unnecessary filler words or intensifiers ("very", "really")
- Sentences average under 15 words and contain only one thought
- Subject precedes the verb in active, direct voice
- No complex or passive sentence constructions

## Do not

- Use passive voice ("was hit by") when active voice ("hit") works
- Pack multiple thoughts or dependent clauses into a single long sentence
- Rely on adverbs to add flavor when a stronger single noun or verb exists
- Settle for the first draft of an opening sentence

## Example transformations

**Before:** "It is very important to note that the team was quite successful in implementing the new features after they were thoroughly tested."

**After:** "The team shipped the new features."

**Before:** "The data was analyzed by the analysts very carefully, and it appeared that sales were declining significantly."

**After:** "Sales dropped 20%."

---

Source: Scott Adams, "The Day You Became A Better Writer" (2007), archived at https://web.archive.org/web/20240302003157/https://dilbertblog.typepad.com/the_dilbert_blog/2007/06/the_day_you_bec.html — the original Typepad post was taken offline when Typepad shut down on 30 September 2025.

© surendranb · MIT · surendranb/writing-skills

Similar skills

All skills for Writing and docs →

From the same set16

yoda Rewrites AI responses into Yoda's sparse, inverted voice using compact sentences and closing aphorisms. Useful when you need a mentoring tone without extra words. CX Codex +1 ★ 53repo stars winnie-the-pooh This skill guides an agent toward gentle prose with plain words and a slow train of thought. Use it for comforting writing that observes rather than lectures. CX Codex +1 ★ 53repo stars ted-lasso A skill that gives your coding agent the Ted Lasso voice: warm, honest, and free of corporate jargon. Useful for team notes, pep talks, and framing setbacks. CX Codex +1 ★ 53repo stars shrek A writing skill that turns prose into the deadpan, grumpy, but warm voice of Shrek, grounding messages with swamp analogies. CX Codex +1 ★ 53repo stars plain-language A skill that rewrites drafts in plain language: short sentences, active voice, no jargon. Useful for anything a reader sees once. CX Codex +1 ★ 53repo stars paddington Directs the assistant to write in the earnest and polite voice of Paddington. Useful for courteous customer replies and incident updates without blame. CX Codex +1 ★ 53repo stars orwells-rules This skill edits drafts using Orwell’s six writing rules, trimming clichés and excess words while favoring active voice. Use it to revise prose written by you or an agent. CX Codex +1 ★ 53repo stars journalism-ap A skill that holds the agent to Associated Press conventions when drafting news copy and press releases: attribution, numbers, dates, no editorializing. Useful when the text has to read as factual reporting. CX Codex +1 ★ 53repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor