riff — Claude Code plugin: what it does, how to install
riff guides personal essays from rough notes to a finished title through focused skills. It keeps the writer involved and preserves a reusable style profile.
MIT ★ 30 updated 2026-04-09
/plugin marketplace add anthropics/claude-plugins-community
/plugin install riff@claude-communityWhat riff does
riff turns personal-essay work into a sequence of nine skills: /sort, /sequence, /compose, /critique, /revise, /copyedit, /title, /checkpoint, and /riff. Seven of them form a path from raw material to a named piece, while each skill can also be used on its own.
/sort extracts the main points from notes or voice memos and keeps leftover material in a separate place. /sequence develops possible structures, /compose drafts the essay, and /critique identifies the most important weakness first. /revise applies feedback without discarding what already works, /copyedit checks grammar and rhythm, and /title explores title directions. /checkpoint stores versions in checkpoints/, while /riff offers a short reset when you are stuck.
On the first /compose or /revise run without a style profile, the plugin asks for a writing sample. You can provide a file, a link, or pasted text. The profile is reused across sessions, and the plugin still lets you work without creating one.
What it helps with
- turn rough notes into a personal essay
- work out a structure for a set of ideas
- find the main weakness in a draft
- apply feedback while keeping the writer’s voice
- save and restore earlier essay versions
Example prompts for the agent
- Use
/sortto find the core ideas in these notes and keep the unused material aside. - Take these sorted points to
/sequenceand suggest a direction for the essay. - Save the current draft with
/checkpointbefore I try another revision.
How to install riff
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install riff@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about riff
How do I install riff in Claude Code?
In Claude Code, run /plugin marketplace add anthropics/claude-plugins-community first, then run /plugin install riff@claude-community.
What does riff do?
It breaks personal-essay writing into skills for sorting material, planning structure, drafting, critique, revision, copyediting, and titles. It also includes version checkpoints and a fallback skill for moments when you are stuck.
Does riff require a writing sample?
The first /compose or /revise run without a style profile asks for a sample, supplied as a file, link, or pasted text. The sample builds a profile that can be reused across sessions.
Source text
SKILL.md · MIT
# Riff: A Claude Plugin for Writing Personal Essays **What is this?** This plugin is a toolkit to help people with the process of writing personal essays in collaboration with Claude. There are nine skills that are part of it: Sort, Sequence, Compose, Critique, Revise, Copyedit, Title, Checkpoint, and Riff. Together, they contain almost everything I know about writing in general, framed specifically to make writing with an LLM more intuitive through different steps. Each skill works on its own, though seven of the nine skills are also designed to work together in a chain. **Why does this exist?** The idea behind this plugin is pretty simple. I wanted to distill the ways I've found LLMs helpful in my personal writing process over the years, and formalize those flows into a set of skills for myself, then open-source everything for other people to use. **What do the skills actually do?** ### /sort This skill takes unstructured material like notes, bullet points, or voice memos and distills that into a set of core points. It assesses the type of material you're working with, consolidates overlapping ideas, and preserves your original language and phrasing. Anything that doesn't fit the main structure goes into a "junk drawer" so nothing gets dropped. When it's done, it'll nudge you toward /sequence if you want to explore how those points might evolve into an essay, or it will suggest that you take time to think about the sorted points first if the underlying material is complex. ### /sequence This skill takes sorted points and helps you figure out how to arrange them into an essay. Before proposing structures, it asks what's driving you to write i.e. whether you want to make an argument, tell a story, explain something, or aren't sure yet. If it detects a genuine structural tension in the material (like competing throughlines), it'll ask a follow up to help you choose a direction. Then it proposes one to three structural options depending on what the material supports. When you've picked a direction, it points you toward /compose. ### /compose This skill writes a full personal essay from structured notes in your voice. If you don't have a style profile yet, it asks for a writing sample to build one (you can upload a file, share a link, or paste text directly). This profile is saved and reused across sessions. It then asks where the essay will be published (Substack, LinkedIn, X, or other) and how long it should be, and those answers are used to calibrate tone and length. After the draft is written, this skill will either suggest sitting with what you've got or it will point you toward /critique for an honest assessment. ### /critique This skill gives an honest assessment of a piece of writing. It opens with the single most important thing to fix, then works through remaining observations in descending order of severity. It evaluates originality, argument quality, fluff, tone, and vulnerability to criticism, focusing on the dimensions that are most relevant to your specific piece. It closes with three simulated social media reactions to show how the piece might land in public. The skill will direct you from here as it sees fit, either to the next step with /revise, or if the feedback points to structural problems, it'll suggest going back to /sort or /sequence rather than pushing forward. ### /revise This skill takes a draft and a set of feedback and produces a stronger draft. It implements feedback point by point while preserving your voice and everything that was already working in the underlying essay. It can push back on feedback it disagrees with rather than blindly implementing everything, and it surfaces those disagreements clearly in its change summary. If the feedback reveals foundational problems, it'll say so and recommend stepping back in the pipeline rather than polishing something that isn't ready. When it's done, it asks whether you'd like to move to /copyedit for a final polish, take another revision pass, or step away and read the draft on your own first. ### /copyedit This skill does a close read of a piece of writing to check for grammar issues, punctuation errors, and sentence rhythm. If the piece still needs structural work, it'll say so and point you toward other skills for continued iteration. It verifies every issue before flagging it to avoid false positives, and if you have a style profile, it reads that first so it doesn't flatten your voice. Each suggestion cites an existing section, states its proposed change to that section, and gives one sentence of reasoning for that change. It can implement whatever changes you like, then when you're happy with the edits, it points you toward /title to help name the piece. ### /title This skill helps you find the right title for a piece through deep analysis of the essay's argument, imagery, and style. It generates title ideas across three categories: two-word, three-word, and longer (up to 10 words), then iterates based on what resonates with you. If something is vibenomically aligned, it digs deeper in that direction. If nothing lands, it reshuffles completely and tries a different angle. ### /checkpoint This skill lets you save, view, and restore versions of your essay as you work with Claude. When you want to preserve the current state of a draft, just say "checkpoint this" or "save this version" and it gets saved to a `checkpoints/` folder alongside your other files, so you can continue experimenting without losing progress. You can browse your saved versions anytime, or restore an earlier draft if a revision went sideways. The other skills will sometimes remind you that checkpointing is available, but it only saves when you ask. ### /riff This skill is for getting unstuck. Call on it at any point in the process and it'll give you a quick, honest read on where things stand with a few practical observations and a nudge toward what to do next. The /riff skill also acts as a fallback in the event other skills aren't triggered. **How do these skills work together?** Seven of the skills form a natural pipeline: sort → sequence → compose → critique → revise → copyedit → title. Each one suggests the next step when it finishes, though you can jump in anywhere or use them independently. That said, at key moments, the plugin will also encourage you to step away and sit with your work before moving on. Checkpoint and riff can be used at any time throughout the process. **How does it handle voice?** The plugin uses a style profile to capture how you write. The first time you use /compose or /revise without a profile, it asks for a writing sample. It analyzes your sample for patterns like sentence rhythm, formality, humor, and how you handle transitions, then saves a profile that gets reused across sessions. You can skip this step and write without a profile, or update it anytime with new samples. The other seven skills don't need a style profile and work immediately. Copyedit and critique will reference the profile if one exists to avoid flattening your voice, but they don't require one. Compose and revise reference your style profile throughout the drafting process to stay in your voice, so longer essays can take a couple of minutes to generate. **Installation** Copy the URL of this GitHub repository. In the Claude desktop app, go to Cowork and click Customize on the left sidebar. Click the Plugins icon, then beside Personal plugins, click the + button to Add plugin. Select Create plugin, then Add marketplace, paste the URL, and click Sync. Once it syncs, you'll be taken to the plugin directory. Switch to the Personal tab, and you'll see Riff available to install. Once installed, the nine skills activate automatically based on what you say in your sessions. You don't need to memorize anything, though you can also call skills directly by name or with their slash commands. **A final note** I made this plugin because I'm a big believer that more people should publish their thoughts and ideas about the world in written form, and if this set of skills helps anyone do that I'll count it as a win. My sense is going forward human writing will leverage AI consistently for certain things, but the writing process will always be a human-led activity, and this plugin is built to help facilitate that collaborative dance. In closing, I will say that this is experimental and I update it often, so if you do mess around with it, all feedback is very welcome. Just submit a GitHub Issue or send me a message on X. Good luck out there and happy riffing.
© benjaroy · MIT · benjaroy/riff