claude

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.

2 on GitHubby FiredMosquito831v0.2.0Apache-2.0updated 24 days ago
/

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-sim

    Speak 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-read

    Load 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-research

    Load 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-craft

    Craft 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-modes

    Creative-writing addendum to /llm-writing. Load when putting prose on the page: draft, revise, bridge, vary, or polish.

  • creative-writing-muse

    Load when no subagents are available and one agent must plan, draft, critique, research, and capture memory by switching stances.

  • demolition

    Load 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

  • export

    Load 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

  • gates

    Load 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-docs

    Use when challenging a plan — grills the author against documented decisions and sharpens terminology.

  • information-hierarchy

    Load 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-modeling

    Use before acting on human instructions: separate what they said from what they meant.

  • kb-integrity

    Load 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-management

    Maintaining 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-layers

    Use when deciding where knowledge goes or reading/writing durable docs: AGENTS.md, .context/, KB, docs/, and work directories.

  • llm-writing

    Load 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-validation

    Use when validating markdown links or Mermaid diagrams.

  • project-setup

    One-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-layer

    Use when writing or maintaining AGENTS.md, .context/CONTEXT.md, or CLAUDE.md mirrors: keep intent docs minimal and load-bearing.

  • reader-sim

    Read 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.

  • reflect

    User-invoked pause before reporting to check intent vs literal completion, surface adjacent wins, and route knowledge capture.

  • series-bible

    Schemas 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

  • series

    Load 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-dao

    Shared 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-ledgers

    Load 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-memory

    Creative-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-planning

    Planning 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-review

    Review 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-artifact

    Load when building a static HTML artifact — single page or multi-page site — to make structured information explorable through layout and navigation.

  • style-guardrails

    Load 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

  • voice

    Load 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-principles

    What 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-staffing

    Dispatch 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-out

    Use when orienting in an unfamiliar area — fans out exploration across structure, knowledge, and history, then synthesizes one orientation map.

Slash commands (8)

  • /vellum:cold-read

    Set up work/cold-reads/<YYYY-MM> from templates/cold-read and run cold-read batches.

  • /vellum:dismiss

    Record an author dismissal of a finding as an exemption (requires the reason in the author own words).

  • /vellum:export

    Evaluate readiness, then build the export bundle.

  • /vellum:init

    Set up a creative-writing project for this plugin — run the project-setup skill (interview, kb layout, CLAUDE.md, initial state rebuild).

  • /vellum:retune

    Run the voice retune protocol from a raw author sample.

  • /vellum:series

    Operate the library/series layer — link books, capture series canon, run retcon checks, plan and apply retcons.

  • /vellum:status

    Print the state card, gate statuses, and open findings summary.

  • /vellum:write-chapter

    Run the chapter loop — outline, author approval, draft, critique, acceptance, capture.

Subagents (16)

  • beta-reader

    Four-reader full-manuscript readiness read before export.

  • blind-reader

    Naive-eyes verdict on a pivotal chapter; knows nothing of the plan.

  • brainstormer

    Creative option generation for a scoped question or angle.

  • character-sim

    In-character conversation for voice discovery and relationship testing.

  • cold-reader

    Executes one cold-read batch; assessment only, never edits.

  • continuity-checker

    Cross-references content against established canon for contradictions.

  • critic

    Deep adversarial critique of a draft, one focus area at a time.

  • disruptor

    Controlled-wildness proposals for flat chapters; proposal-only.

  • editor

    Holistic third-party book editor pass across narrative structure, voice, line quality, copy consistency, and proofreading priority.

  • kb-lead

    Knowledge-capture worker; writes only under kb/ and runs engine checks after updates.

  • muse

    Author-facing creative partner for all story work, from planning through production handoff; enforces the three hard gates and routes all specialist work.

  • outliner

    Sequences confirmed direction into arc, chapter, and beat-level outlines.

  • reader-sim

    Experiential reader response from a caller-specified reader persona; pass the persona, draft, and knowledge boundary.

  • style-creator

    Analyzes prose samples to produce style reference files for the project's voice.

  • web-researcher

    Web research for fiction — primary sources, reference works, cultural detail, domain expertise, and community discussion.

  • writer

    Production 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"

View source on GitHub vellum.danubelabs.net

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.

claude & codex pluginslisted