Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
haowjy avatar

Project Setup

  • 268 installs
  • 384 repo stars
  • Updated July 31, 2026
  • haowjy/creative-writing-skills

One-time creative-writing project bootstrap so every later agent session reads the same CLAUDE.md, kb layout, and optional style files.

About

Project Setup is an agent skill for solo fiction and serial authors who want Claude Code (or similar agents) to respect their voice, world, and folder habits from day one. Instead of repeating context in every chat, the skill runs a structured interview: project shape, progress, POV and timeline complexity, and where files already live. It gathers writing samples into kb/samples/, outlines a knowledge-base layout, and writes CLAUDE.md so every future creative-writing skill in the repo shares the same rules. When samples are sufficient, it can kick off style-analysis to seed kb/styles/. Use it once at project start or when migrating a messy draft tree into an agent-friendly structure—before heavy drafting, revision, or continuity checks.

  • Interviews you on project type, POV, timeline, and where existing drafts live
  • Collects writing samples into kb/samples/ for later voice analysis
  • Proposes kb directory structure aligned to novel, serial, or short-fiction workflows
  • Generates CLAUDE.md with project-specific agent conventions
  • Optional handoff to /style-analysis when enough sample material exists

Project Setup by the numbers

  • 268 all-time installs (skills.sh)
  • +39 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #940 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/haowjy/creative-writing-skills --skill project-setup

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs268
repo stars384
Last updatedJuly 31, 2026
Repositoryhaowjy/creative-writing-skills

What it does

One-time creative-writing project bootstrap so every later agent session reads the same CLAUDE.md, kb layout, and optional style files.

Files

SKILL.mdMarkdownGitHub ↗

Project Setup

Guide the author through setting up their creative writing project. The goal is a working CLAUDE.md and directory structure that all agents read for project-specific conventions, plus initial style files if writing samples are available.

Learn About the Project

Ask about:

  • What kind of project: novel, short story collection, serial?
  • How far along: starting fresh, or existing chapters and worldbuilding?
  • Single POV or multiple? Linear or non-linear timeline? How much worldbuilding?
  • Where do they keep their writing? What's the existing layout?

Writing Samples and Style

Ask about writing samples: these are the foundation for style analysis:

  • Do they have sample chapters or scenes already written?
  • Do they have writing from other projects that captures the voice they want?
  • Are there published works they want to draw style inspiration from?
  • Voice goals: close third, omniscient, first person? Formal, colloquial?

Collect whatever they have. Save samples to kb/samples/ so they're available for future style analysis. If they have enough material, offer to analyze their style using the /style-analysis methodology: read the samples, identify the voice dimensions, and produce initial style files in kb/styles/.

If they're starting fresh with no samples, capture their voice goals in CLAUDE.md so style files can be created from early drafts.

Propose and Iterate

Based on what you learn, draft a CLAUDE.md section and show it to the author. Cover:

  • Project overview: what the project is, one paragraph
  • Author's space: where the author keeps their writing and how it's

organized

  • KB structure: what subdirectories exist under kb/ and what they're

for. Suggest based on project complexity:

  • Simple (short story, single POV): characters/, canon/, styles/, root vocab.md
  • Medium (novel, few POVs): add timeline/
  • Complex (series, large world): add world/, issues/, and domain vocab files such as world/vocab.md
  • Voice and style: what style files exist, what samples they're derived

from, voice goals not yet captured

  • Conventions: anything project-specific: naming patterns, chapter

numbering, POV tagging, spoiler handling

  • Shared vocabulary: early canonical terms, aliases, invented words,

genre terms with project-specific meanings, and terms the author wants agents to avoid or distinguish

Present the draft and let the author adjust. Iterate until they're satisfied.

Create the Files

Once approved:

1. Write or update CLAUDE.md with the agreed content 2. Create the kb/ directories referenced in CLAUDE.md 3. Create kb/vocab.md when the project has named concepts agents must use consistently; create domain vocab files when a domain already has enough distinct terms 4. Create work/ with standard subdirectories (outline/, drafts/, critique-reports/, brainstorm/) 5. Save any writing samples to kb/samples/ 6. If samples were provided and the author wants style analysis, produce initial style files in kb/styles/

Existing Projects

If CLAUDE.md already has creative writing conventions, read it first and suggest updates rather than overwriting.

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.