BeClaude

creative-writing-skills

134Community RegistryGeneralby Jimmy Yao

A set of composable agents and skills for creative writing projects. The story-orchestrator agent is the primary entry point — it coordinates brainstorming, drafting, critique, and knowledge maintenance across all specialized agents.

First seen 4/17/2026

Overview

![CI](https://github.com/haowjy/creative-writing-skills/actions/workflows/ci.yml) ![License](LICENSE)

Write novels, short stories, and serial fiction with AI that maintains your voice, tracks your continuity, and gets better the more you use it. From first brainstorm to polished draft: specialized agents handle each mode of work (writing, critiquing, revising, exploring) while shared skills carry the craft methodology.

What you get:

  • Brainstorm without committing: explore plot options, character arcs, and world mechanics with multiple AI perspectives before deciding anything
  • Write in your voice: create style files from your existing prose, then draft new scenes that match
  • Catch your own mistakes: structured critique, continuity checks, and simulated reader reactions
  • Keep everything in sync: knowledge base updates as your story evolves

Quick Start

bash
meridian mars add haowjy/creative-writing-skills
meridian mars sync
meridian bootstrap

Installation

Mars (Meridian)

bash
meridian mars add haowjy/creative-writing-skills
meridian mars sync

Then run meridian to start a session with muse. First-time setup runs the bootstrap automatically.

Claude Code / Cowork

Claude Code and Cowork use the same plugin format.

Claude Code: add the marketplace and install:

bash
/plugin marketplace add haowjy/creative-writing-skills
/plugin install creative-writing-skills@cw

Cowork: in the sidebar, CustomizePersonal plugins+Create pluginsAdd marketplaceAdd from repository, enter haowjy/creative-writing-skills, then install the creative-writing-skills plugin. (Same flow as Claude.ai below — Cowork just also runs the agents.)

Once installed, start a session with muse as your agent:

bash
claude --agent creative-writing-skills:muse

Run the one-time project setup to create your CLAUDE.md and kb/ structure:

code
/creative-writing-skills:project-setup

Claude.ai

cw-muse turns an ordinary Claude chat into a creative-writing partner. Turn it on, tell it what you're working on, and it carries you from first idea to finished draft in one conversation — talking through ideas, drafting scenes in your voice, flagging what isn't working, and revising. The other skills (prose, scene craft, critique, structure) are the craft knowledge it draws on; you don't have to invoke them yourself.

First, add the skills to claude.ai — pick one:

  • Add the marketplace (easiest): in the sidebar, CustomizePersonal plugins+Create pluginsAdd marketplaceAdd from repository, enter haowjy/creative-writing-skills, and click Sync.

!Adding the marketplace in claude.ai: the plugins icon and + in the sidebar, with the repository entered in the Add marketplace dialog

  • Upload the files: download the .skill files from the latest release, then CustomizeSkills"+"Upload skill for each one.

Then start a chat, turn on `cw-muse`, and describe what you want to write — it leads from there. Adding skills one at a time instead? Start with cw-muse, writing-principles, prose-writing, scene-construction, and prose-critique.

Want to build the files yourself? Clone the repo and run python scripts/create_skill_zips.py to regenerate them in zips/.

How It Works

mermaid
flowchart TB
    You([You]) --> M[muse]

    M --> Explore
    M --> Draft
    M --> Maintain

    subgraph Explore ["Explore & Plan"]
        direction LR
        B[brainstormer] ~~~ CS[character-sim]
        CS ~~~ O[outliner]
    end

    subgraph Draft ["Draft & Revise"]
        direction TB
        W[writer] --> CR[critic]
        CR -->|synthesis| RW[revision-writer]
        RW -.->|iterate| CR
        M -.->|pivotal scenes| RS[reader-sim]
        M -.->|voice check| CC[continuity-checker]
    end

    subgraph Maintain ["Knowledge"]
        direction LR
        CH[chronicler]
        SC[style-creator]
    end

    Explore -->|direction confirmed| Draft
    Draft -->|decisions & facts| Maintain
    Maintain -.->|context for next session| Explore

Explore: Fan out brainstormers for creative variety. Spawn character-sims to discover voices. Use outliners to shape structure once a direction is chosen.

Draft & Revise: Muse runs the write/critique/revise loop: writer produces prose, critics evaluate across the four reward channels (transportation, aesthetic, social simulation, flow), revision-writer fixes specific issues. Reader-sim gives experiential signal on pivotal scenes.

Knowledge: Chronicler extracts facts from completed chapters into the kb. Style-creator captures voice patterns from prose samples. The kb grows as the project evolves, giving every future agent accurate context.

Agents

AgentRole
museAuthor's creative partner: intent capture, brainstorming, drafting loops, knowledge maintenance
writerGenerative prose from scene briefs in the project's voice
revision-writerSurgical revision from critique: preserves voice, fixes specific issues
bridge-writerTransitions, time compression, connective passages between pivotal scenes
criticAdversarial critique across the four reader reward channels
reader-simSimulates a reader's experience, reports moment-by-moment
character-simIn-character voice performance for discovery and relationship testing
continuity-checkerChecks drafts against established canon
brainstormerWide-open option generation on a scoped question
outlinerStructural decomposition into beat sheets and arc maps
style-creatorAnalyzes existing prose to create style reference files
chroniclerExtracts story facts from chapters into the kb

Skills

SkillPurpose
writing-principlesFour reward channels, AI failure modes, reader psychology
prose-writingImmersion patterns: psychic distance, rhythm, sensory grounding, interiority
scene-constructionBeat-level craft: scene entry, dialogue, pacing, transitions
prose-critiqueAdversarial reading methodology with focus areas
style-analysisHow to analyze prose and produce style reference files
story-architectureArc shape, tension curves, structural analysis
story-contextContext scoping: what to pass to each agent type
shared-daoShared vocabulary: canonical story terms, aliases, and ambiguity resolution
brainstormingExploratory capture with source tagging
kb-managementMaintaining the story knowledge base: page conventions, organization, when to create vs update
writing-artifactsFile conventions: kb/ for durable knowledge, work/ for scratch
writing-issuesIssue tracking across revision cycles
writing-staffingTeam composition: which agents, how many, what focus areas
project-setupOne-time guided setup: interviews about the project, creates CLAUDE.md and kb structure
llm-writingGeneral LLM writing discipline: behavioral pulls and document-writing guardrails

Project Layout

text
my-story/
├── CLAUDE.md              # Project conventions (created by project-setup)
├── story/                 # Chapters and manuscript
├── work/                  # Current drafting effort
│   ├── outline/
│   ├── drafts/
│   ├── critique-reports/
│   └── brainstorm/
└── kb/                    # Durable knowledge base
    ├── styles/            # Voice reference files
    ├── characters/        # Character state and profiles
    ├── world/             # Locations, lore, systems
    ├── timeline/          # Chronology
    ├── canon/             # Established facts
    └── issues/            # Tracked writing problems

Compatibility

FeatureClaude CodeCoworkMars (Meridian)Claude.ai
All agentsYes (flat)Yes (flat)Yes (hierarchical)No (grayed out in chat)
All skillsYesYesYesMarketplace add or zip
Multi-agent orchestrationVia museVia museVia muse → bard → workersNo
Project setupYesYesYesNo

Claude Code and Cowork use the same plugin format with all agents as flat subagents under muse. The Meridian version adds intermediate orchestrators (bard for drafting, lore-keeper for knowledge maintenance) for deeper context isolation. You can add the marketplace to the Claude desktop app from GitHub; Cowork runs the agents, but plain claude.ai chat runs skills only (agents grayed out) — there the cw-muse skill provides the session-lead orchestration in a single conversation, backed by the craft skills.

Current Experiments

Rhetorical questions in skill prompts. The economy section in writing-principles uses rhetorical questions ("what can you leave out and still have the scene work?") rather than declarative statements. LLMs can distinguish rhetorical from information-seeking questions internally (arxiv 2604.14128), and Self-Ask prompting shows questions improve reasoning, but no research directly tests whether rhetorical questions in system prompts improve task performance vs. equivalent declaratives. Keeping the rhetorical form to see if it activates a self-check loop that declaratives don't.

Development

Validate package

bash
meridian mars check

Release

bash
mars version patch              # bump, commit, tag
mars version patch --push       # bump, commit, tag, push

License

Apache License 2.0. See LICENSE.

Install & Usage

1
Create the agents directory
mkdir -p .claude/agents
2
Save the agent file

Add the configuration to .claude/agents/creative-writing-skills.md

3
Invoke with @agent-name
@creative-writing-skills
View source on GitHub
agent

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is creative-writing-skills?

A set of composable agents and skills for creative writing projects. The story-orchestrator agent is the primary entry point — it coordinates brainstorming, drafting, critique, and knowledge maintenance across all specialized agents.

How to install creative-writing-skills?

To install creative-writing-skills: create the agents directory (mkdir -p .claude/agents), then add the config to .claude/agents/creative-writing-skills.md. Finally, @creative-writing-skills in Claude Code.

What is creative-writing-skills best for?

creative-writing-skills is a agent categorized under General. It is designed for: agent. Created by Jimmy Yao.