Templates · Writing & publishing
Essay (Paul Graham) template
For an idea you want to work out in public. Origin: Paul Graham's essays and his notes on writing them ("The Age of the Essay", "Write Simply", "How to Write Usefully"): one question, followed wherever it leads, in plain words.
Structure
- A question or a surprising claim
- Short paragraphs that each move the argument one step
- Concrete examples, ideally from the writer's own experience
- Objections taken seriously
- An ending that says something the beginning could not
How a tough reader scores it
When you score a draft against this format, the Critic evaluates this essay. The weights add up to 100; the fixes for the weakest criteria arrive as cards in the editor.
| Criterion | Weight |
|---|---|
| Says something true that most readers had not already thought | 25 |
| The argument moves: each section adds a step, none restates | 20 |
| Examples are concrete and specific, ideally first-hand | 15 |
| The strongest objection is stated fairly and answered | 15 |
| Language is plain: simple words, short sentences, no hedging | 15 |
| The ending is sharper than the opening | 10 |
How it works in SecondPen.ai
Open the template and the editor writes the blank once, with a line of guidance under each heading that you delete as you fill it in. Write your abstract and the editor names the format it reads like. Ask for a document with a slash command and it offers to start from the matching format. When the draft is ready, the Critic scores it against the criteria above, the way this format's toughest reader would, and the three highest-leverage fixes become Editor cards.
More in Writing & publishing
- Engineering blog post (how we built it)a launch, a migration, an outage write-up or a performance win
- Op-ed (The OpEd Project)an opinion piece for a newspaper, a trade publication or a company blog taking a position
- Listiclea roundup, a set of tips, tools or lessons that do not need to be read in order
- Tutorial (Diátaxis)a getting-started guide or a "build your first X" post
- How-to guide (Diátaxis)"How to do X in Y" posts and internal guides
- Explainer"What is X and why does it matter", a concept, a controversy or a system explained for a curious reader
- Launch announcement posta product, feature or company launch on a blog or a changelog
- Newsletter issuea weekly or monthly issue to subscribers