claudeers.
// Claude Skills

jp-essay

A Claude Code skill that makes a model write an essay the slow way, with a script checking every step.

// Claude Skills[ cli ][ api ][ web ][ claude ]#claude#ai-writing#claude-code#claude-skill#essay-writing#writing#skills◷ MIT$open-sourceupdated 17 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up jp-essay (claude-skill project) into my current project.
Found on https://claudeers.com/jp-essay
Repo: https://github.com/lucasbabur/jp-essay
Homepage/docs: https://jpessay.com
Detected install method: claude-skill → # copy this skill into .claude/skills/jp-essay/
Category: skills. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/jp-essay/   (or ~/.claude/skills/jp-essay/ for all projects)
// or clone
git clone https://github.com/lucasbabur/jp-essay

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
jp-essay icon

jp-essay

A Claude Code skill that runs Jordan Peterson's essay process, adapted to how models write.

Question, reading list, outline, bad draft, outline from memory, reorder, rewrite, ask again.

Website · Read a sample essay


Peterson's writing guide is built for students, whose problem is skipping the work: no question, no reading, no outline, one draft. A model has the opposite problem. It does every step fluently and still produces generic prose: no claim worth arguing, no specifics, inflated words, hedged verdicts and an ending that summarizes. jp-essay keeps Peterson's steps and aims each one at the model's failure. A script checks every step, so the model can't skip one and say it's done, and no model grades the prose, because models asked to judge writing barely beat chance and reward overwriting.

Not affiliated with Jordan Peterson. jp-essay is an independent project. Jordan B. Peterson has not reviewed or endorsed it. It is an iteration of the method in his writing guide, adapted for AI agents.

Contents

How it works

You answer one short form at the start. After that the skill runs on its own until the essay is finished.

#Peterson's stepHow the model runs itWhy it changed
1QuestionOne question a reader could answer two ways, plus who the reader is. You confirm it.The reader decides what to explain, which kills glossary clutter.
2Reading listA research subagent gathers facts, scenes, numbers and verbatim quotes, questioning from a skeptic's, a newcomer's and an expert's point of view. Your own records count for essays about you.Specifics are the cure for genericness.
3OutlineA thesis that answers the reader's own question (what to do, not what the studies found), a carrier (the person or case the reader follows) and a puzzle the ending answers, then one sentence per paragraph. A critic attacks it.Peterson's ten per thousand words is the centre, not a quota.
4Bad draftWritten straight through by one author in a smart friend's voice, carried by the case, 15% long, with at most one named study per paragraph and the figures that make each claim concrete; extra detail goes to short footnotes.No sentence quotas per paragraph: they make a model write choppy sentences. The study budget keeps a well-researched essay from reading like a literature review.
5Outline from memoryA fresh reader reads the draft once and outlines it from memory, and says where it would have stopped reading by choice.A model can't forget its own draft, so someone else remembers. Understanding a paragraph isn't the same as wanting to read the next one.
6ReorderRecall and outline compared; a new outline; paragraphs, then sentences, reordered and rebuilt on it.Structure is fixed before sentences, so no polish is spent on paragraphs that move or vanish.
7Rewrite sentencesAn editor marks flawed spans at four levels of resolution (word, sentence, paragraph, essay). Each gets three genuinely different versions, or a reason it stands.Three versions of every sentence makes a model change good sentences; three versions of the flawed ones doesn't.
8Fact-checkA fact-checker marks every claim supported, fixed or cut against the notes, and changes nothing else.Easy prose makes claims feel truer, so accuracy gets its own pass and never restyles. Not in Peterson.
9Can it be better?A second cold read. Done when its recall matches the outline and the reader would have kept reading.One round: every further round of self-revision drifts from the essay's intent.

Install

You need Claude Code and uv. The checker declares its own Python dependencies.

npx jp-essay@latest

That installs both /jp-essay and /jp-essay-scientific into ~/.claude/skills. Start a new Claude Code session and they're there. To update later, run npx jp-essay@latest --force. npx jp-essay doctor checks that Claude Code and uv are installed.

To track the repo instead, clone it:

git clone https://github.com/lucasbabur/jp-essay ~/.claude/skills/jp-essay && ~/.claude/skills/jp-essay/install.sh

Update a clone with git -C ~/.claude/skills/jp-essay pull.

Usage

/jp-essay Why do we procrastinate on things we care about? 1200 en
/jp-essay <question or topic> [word count] [language]
  • Length: at least 500 words, 1,000 by default. The length is a ceiling: the final essay lands between 90% of the target and the target.
  • Language: en or pt. The default is the language you asked in.

Scientific edition

/jp-essay-scientific runs the same process for an academic reader. Sources must be published works, drafts mark borrowed claims with [@id], and the essay ends with in-text citations and a reference list in your style (APA by default, ABNT and others on request).

/jp-essay-scientific What made dinosaurs dominate the land? 1500 en APA

What you get

Each essay gets its own folder under ~/Documents/essays/<slug>/:

what-made-dinosaurs-dominate-land/
├── question.md        # question, reader, length, language (+ style if scientific)
├── sources.md         # material: facts, scenes, numbers, verbatim quotes
├── research.md        # three readers' questions, the strongest objection, gaps
├── outline.md         # the thesis, then one claim per paragraph
├── outline-review.md  # APPROVED, or numbered objections
├── draft.md           # the bad draft
├── reader.md          # a cold reader's outline from memory, and what it took away
├── outline-2.md       # the outline the essay follows after the recall
├── draft-2.md         # the draft rebuilt and reordered on it
├── edits.md           # flawed spans, by level of resolution
├── rewrites.md        # three versions of each flawed span, or why it stands
├── facts.md           # every claim: supported, fixed or cut
├── reader-2.md        # the last cold read
└── final.md           # the finished essay ✦

Sample essay

Do We Sleep to Wash the Brain? came out of one unedited run with a 500-word ceiling. It follows the reader through the morning after an all-nighter, across a 2013 study, a 2024 study that contradicts it, a sleep-deprivation experiment in Oslo and a 2025 twist. The fact-check covered 32 claims and fixed one. Read it on the website.

The gates

check.py checks only what a script can see. A step counts as done when its gate prints PASS:

~/.claude/skills/jp-essay/check.py <gate> <essay-dir>
GateChecks
questionQuestion, reader, length ≥ 500 and language present
sourcesAt least three sources, notes on each, every link fetched or local file found
outlineA thesis sentence; one point per 80 to 250 words; every cited id exists
draftLength up to 15% over; no headings; mechanical tells
recallOne recall sentence per paragraph, in the reader's own words; all eight report sections
outline2The new outline is well formed and draft-2.md has one paragraph per point
rewriteOne block per flawed span; three distinct versions or a reason; every choice reaches final.md
factsEvery claim in the fact-check is supported (with a source id), fixed or cut, and supported claims are in final.md
finalTitle; length between 90% of the target and the target; quotes verbatim from the notes; mechanical tells; citations in scientific mode

The mechanical tells are AI vocabulary, filler, stock openers, "serves as", "not X but Y", dashes used as punctuation, duplicated sentences, three sentences in a row with the same opening, and a summary closing paragraph. Quoted source text is exempt. Warnings flag paragraphs with more than five figures, sentences over 40 words, staged run-ups ("And the result?"), paragraph-ending fragments, curly quotes and heavy use of parentheses.

Development

uv run --with pytest==8.3.4 --with pysbd==0.3.4 --with httpx==0.28.1 pytest -q test_check.py
npm test   # the npx installer

Publishing a GitHub release publishes the package to npm (.github/workflows/publish.yml).

The website, jpessay.com, is landing/, deployed on Vercel. Preview it with python3 -m http.server -d landing 8774 --bind 127.0.0.1.

Clarity traffic attribution uses explicit UTMs first, then the referring domain, and retains the entry source across internal pages for 30 minutes of inactivity. Filter by the native UTM Source/Medium/Campaign fields or the custom tags traffic_source, traffic_medium, traffic_campaign, and attribution_method. Custom tags also cover recognized referrals without UTMs. Missing referrers are labeled direct_or_unknown; Google search referrals are labeled google / organic. Organic search links do not need UTMs. Use these links for posts:

PlatformLink
Reddithttps://jpessay.com/?utm_source=reddit&utm_medium=social&utm_campaign=jp_essay
Xhttps://jpessay.com/?utm_source=x&utm_medium=social&utm_campaign=jp_essay
Blueskyhttps://jpessay.com/?utm_source=bluesky&utm_medium=social&utm_campaign=jp_essay
DEV.tohttps://jpessay.com/?utm_source=devto&utm_medium=referral&utm_campaign=jp_essay

These links work with Clarity after the tracking branch is deployed. For a local tracking test, open http://127.0.0.1:8774/?clarity=1&utm_source=reddit&utm_medium=social&utm_campaign=jp_essay. Local tests are tagged environment=local_test; plain local previews and hosted preview deployments do not collect data. Use ?clarity=0 to stop local collection in the current tab.

Credits

The process follows Jordan B. Peterson's Writing Guide, adapted for a model. The adaptations draw on Chakrabarty et al. (CHI 2025) on how editors fix model prose, STORM on perspective-driven research, and AI-Slop to AI-Polish on why models can't grade writing. The style rules draw on Steven Pinker's classic style, Paul Graham's essays on writing, George Orwell's six rules and ASD-STE100's one-word-per-meaning rule. The tells draw on Wikipedia's Signs of AI writing, humanizer and stop-slop. This project is independent and is not affiliated with or endorsed by any of them. The icon is an abstract figure, not a portrait of anyone.

License

MIT

// faq

What is jp-essay?

A Claude Code skill that makes a model write an essay the slow way, with a script checking every step.. It is open-source on GitHub.

Is jp-essay free to use?

jp-essay is open-source under the MIT license, so it is free to use.

What category does jp-essay belong to?

jp-essay is listed under skills in the Claudeers registry of Claude-compatible tools.

13 views
★ 83 stars
unclaimed
updated 17 days ago

// embed badge

jp-essay on Claudeers
[![Claudeers](https://claudeers.com/api/badge/jp-essay.svg)](https://claudeers.com/jp-essay)

// retro hit counter

jp-essay hit counter
[![Hits](https://claudeers.com/api/counter/jp-essay.svg)](https://claudeers.com/jp-essay)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how jp-essay connects across the ecosystem