vellum
A working novelist's daily tool for Claude Code: one command for the chapter loop, three hard gates, everything else advisory and silent when clean. The muse agent is the primary entry point; the deterministic Python engine (scripts/vellum) absorbs every check no LLM should burn tokens on.
Plugin vellum from marketplace my-writing-companion in FiredMosquito831/my-writing-companion. Commands read from the repo's manifest — 23 days ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.
What it installs
Skills (34)
character-simSpeak as a specified character from their current knowledge, voice, and emotional state. Use for skill-only workflows that need in-character conversation, voice discovery, or relationship pressure tests.
cold-readLoad for /vellum:cold-read, after every major editorial program, and before export. The cold-read skill owns the cover-to-cover cold-read protocol: the reader charter, the rolling ledger, the append-only issue log, and the batching/orchestration model. It finds the accumulating-memory defect classes
creative-researchLoad when a story needs factual grounding the writer doesn't have: historical detail, cultural texture, domain accuracy, or how other authors handled similar material. Pass the question and story context; returns a sourced report the writer can draw from.
creative-writing-craftCraft references for writing fiction well: prose, scenes, style, voice, and genre/page-level technique. Load when a writer, critic, or muse needs how-to-write guidance rather than a production mode.
creative-writing-modesCreative-writing addendum to /llm-writing. Load when putting prose on the page: draft, revise, bridge, vary, or polish.
creative-writing-museLoad when no subagents are available and one agent must plan, draft, critique, research, and capture memory by switching stances.
demolitionLoad when the author invokes demolition on a chapter draft, or when muse offers it before marking a chapter final. The demolition skill is hostile critical analysis applied to fiction: it finds every vulnerability in a chapter — one at a time, never softened, no solutions during demolition — and log
exportLoad for /vellum:export. The export skill is the operator's manual for building the final manuscript: it runs the readiness gate, interprets a failure as a prioritized fix list, runs the deterministic build on PASS, and explains the manifest and the pandoc fallback. The engine implementation lives i
gatesLoad when muse accepts a pivotal chapter, before export, or for any scoring task. The gates skill owns the shared quality rubric, the export-readiness checklist, the shared finding schema, and the numeric genre profiles. Every critic and gate-owning agent loads this so verdicts are consistent and cr
grill-with-docsUse when challenging a plan — grills the author against documented decisions and sharpens terminology.
information-hierarchyLoad for large human-facing outputs: reports, docs, multi-section explanations, artifacts. Choose the right form for each beat (prose, diagram, table, mockup) and put the answer first, depth behind it. If the medium allows, use progressive disclosure.
intent-modelingUse before acting on human instructions: separate what they said from what they meant.
kb-integrityLoad when a vellum check failed, or when muse routes integrity work. The kb-integrity skill teaches how to run the deterministic engine (bible validate, ledger check, wordcount, state check, knowledge --as-of), interpret their findings, apply the exemption protocol, and repair derived files. It is t
kb-managementMaintaining the story knowledge base: creating, updating, and organizing wiki-style reference pages in kb/. Use when capturing finalized story knowledge, updating character profiles, documenting world mechanics, or restructuring the kb.
knowledge-layersUse when deciding where knowledge goes or reading/writing durable docs: AGENTS.md, .context/, KB, docs/, and work directories.
llm-writingLoad before writing or revising human-facing text. Choose words deliberately, ground the piece in the reader's context, and remove default LLM phrasing before the final draft.
md-validationUse when validating markdown links or Mermaid diagrams.
project-setupOne-time project setup for creative writing. Interviews you about your project, collects writing samples, proposes kb structure, and creates CLAUDE.md with project conventions.
qi-layerUse when writing or maintaining AGENTS.md, .context/CONTEXT.md, or CLAUDE.md mirrors: keep intent docs minimal and load-bearing.
reader-simRead as a specified first-time reader persona and report the felt experience. Use for skill-only workflows when a draft needs persona-bound reader-response signal instead of analytical critique.
reflectUser-invoked pause before reporting to check intent vs literal completion, surface adjacent wins, and route knowledge capture.
series-bibleSchemas and conventions for the series bible (`series/bible.json`) and the rest of the library layer's JSON state, plus how book kb maintenance maps onto series canon. Load when inspecting or planning changes to bible entities and fields, deciding between a `value` and a `by-book` encoding, setting
seriesLoad for any series-layer workflow: linking a book to a library, bootstrap and retcon lifecycle, the retcon detection catalog, the do-not-re-explain register, handoff generation, and the series state card. Owns the `library` subcommand dispatch surface (§8) and is the operator's manual for the serie
shared-daoShared vocabulary for creative writing projects. Load when establishing canonical story terms, resolving ambiguous names, checking term consistency, or deciding where vocabulary belongs in kb/.
story-ledgersLoad when planning chapters, capturing what a chapter changed, or answering what is still open or who knows what. The story-ledgers skill owns the deterministic continuity layer: the ledger file schemas (promises, questions, knowledge, props, characters, clock), the fixed-section state card, and the
story-memoryCreative-writing domain knowledge for durable story state. Load when preserving or retrieving project memory — fact extraction, context scoping, reference writing, artifact layout, and issue tracking. If you are a knowledge agent such as kb-lead, load this for the fiction-specific categories and con
story-planningPlanning work before prose: creative direction, story-planning, outlining, and story architecture. Load when deciding what should happen or how a story should be structured.
story-reviewReview work after prose exists: editorial review, craft critique, continuity/voice review, copyediting, proofreading, and synthesis of reader-sim signal. Load when diagnosing a draft rather than rewriting it.
structured-artifactLoad when building a static HTML artifact — single page or multi-page site — to make structured information explorable through layout and navigation.
style-guardrailsLoad for the writer and critics before drafting or critiquing prose; also drives the post-write net. The fiction-specific anti-slop reference: tiered word tables, structural caps, smell tests, and the carve-out filter that keeps the mechanical net from flattening voice. Load whenever prose is being
voiceLoad for project-setup voice capture, every drift_interval chapters, or when the author says the prose does not sound like them. The voice skill owns the voice lifecycle: capture, measured profile, exemplars/anti-exemplars, drift checks, the blind-tag falsification test, and retune. It is the strong
writing-principlesWhat fiction readers want (reader reward channels) and the specific ways LLM training damages them. Load when drafting prose, critiquing, or diagnosing why a passage feels flat.
writing-staffingDispatch reference for composing writing teams. Teaches which skills to load for each subagent, which resources to reference, and when to fan out versus run parallel lanes. Load when staffing a workflow.
zoom-outUse when orienting in an unfamiliar area — fans out exploration across structure, knowledge, and history, then synthesizes one orientation map.
Slash commands (8)
/vellum:cold-readSet up work/cold-reads/<YYYY-MM> from templates/cold-read and run cold-read batches.
/vellum:dismissRecord an author dismissal of a finding as an exemption (requires the reason in the author own words).
/vellum:exportEvaluate readiness, then build the export bundle.
/vellum:initSet up a creative-writing project for this plugin — run the project-setup skill (interview, kb layout, CLAUDE.md, initial state rebuild).
/vellum:retuneRun the voice retune protocol from a raw author sample.
/vellum:seriesOperate the library/series layer — link books, capture series canon, run retcon checks, plan and apply retcons.
/vellum:statusPrint the state card, gate statuses, and open findings summary.
/vellum:write-chapterRun the chapter loop — outline, author approval, draft, critique, acceptance, capture.
Subagents (16)
beta-readerFour-reader full-manuscript readiness read before export.
blind-readerNaive-eyes verdict on a pivotal chapter; knows nothing of the plan.
brainstormerCreative option generation for a scoped question or angle.
character-simIn-character conversation for voice discovery and relationship testing.
cold-readerExecutes one cold-read batch; assessment only, never edits.
continuity-checkerCross-references content against established canon for contradictions.
criticDeep adversarial critique of a draft, one focus area at a time.
disruptorControlled-wildness proposals for flat chapters; proposal-only.
editorHolistic third-party book editor pass across narrative structure, voice, line quality, copy consistency, and proofreading priority.
kb-leadKnowledge-capture worker; writes only under kb/ and runs engine checks after updates.
museAuthor-facing creative partner for all story work, from planning through production handoff; enforces the three hard gates and routes all specialist work.
outlinerSequences confirmed direction into arc, chapter, and beat-level outlines.
reader-simExperiential reader response from a caller-specified reader persona; pass the persona, draft, and knowledge boundary.
style-creatorAnalyzes prose samples to produce style reference files for the project's voice.
web-researcherWeb research for fiction — primary sources, reference works, cultural detail, domain expertise, and community discussion.
writerProduction prose from scene briefs, revision notes, and style references; uses progressive mode guidance for fresh drafts, revisions, bridges, alternate takes, and line polish.
Hooks (7)
- PreToolUse
bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/guard-outline-before-prose.sh"
- PreToolUse
bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/guard-bash-prose-writes.sh"
- PostToolUse
bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/check-prose-after-write.sh"
- SessionStart
bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-start.sh"
- PreCompact
bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/pre-compact.sh"
- Stop
bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-stop.sh"
- SubagentStop
bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/chapter-maintenance.sh"
Maintain vellum?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.