Project setup skill

One-time project setup for creative writing.

by haowjy·Apache-2.0 license·★ 506 Stars on the repo·GitHub ↗

Use now

Files of Project setup

haowjy/main1 file shown
SKILL.md
Show the full text82 lines

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 /creative-writing-craft 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.

1---
2name: project-setup
3description: >
4 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.
5---
6 
7# Project Setup
8 
9Guide the author through setting up their creative writing project. The goal
10is a working `CLAUDE.md` and directory structure that all agents read for
11project-specific conventions, plus initial style files if writing samples are
12available.
13 
14## Learn About the Project
15 
16Ask about:
17 
18- What kind of project: novel, short story collection, serial?
19- How far along: starting fresh, or existing chapters and worldbuilding?
20- Single POV or multiple? Linear or non-linear timeline? How much worldbuilding?
21- Where do they keep their writing? What's the existing layout?
22 
23## Writing Samples and Style
24 
25Ask about writing samples: these are the foundation for style analysis:
26 
27- Do they have sample chapters or scenes already written?
28- Do they have writing from other projects that captures the voice they want?
29- Are there published works they want to draw style inspiration from?
30- Voice goals: close third, omniscient, first person? Formal, colloquial?
31 
32Collect whatever they have. Save samples to `kb/samples/` so they're available
33for future style analysis. If they have enough material, offer to analyze
34their style using the `/creative-writing-craft` methodology: read the samples,
35identify the voice dimensions, and produce initial style files in `kb/styles/`.
36 
37If they're starting fresh with no samples, capture their voice goals in
38CLAUDE.md so style files can be created from early drafts.
39 
40## Propose and Iterate
41 
42Based on what you learn, draft a `CLAUDE.md` section and show it to the
43author. Cover:
44 
45- **Project overview**: what the project is, one paragraph
46- **Author's space**: where the author keeps their writing and how it's
47 organized
48- **KB structure**: what subdirectories exist under `kb/` and what they're
49 for. Suggest based on project complexity:
50 - Simple (short story, single POV): `characters/`, `canon/`, `styles/`, root `vocab.md`
51 - Medium (novel, few POVs): add `timeline/`
52 - Complex (series, large world): add `world/`, `issues/`, and domain vocab files such as `world/vocab.md`
53- **Voice and style**: what style files exist, what samples they're derived
54 from, voice goals not yet captured
55- **Conventions**: anything project-specific: naming patterns, chapter
56 numbering, POV tagging, spoiler handling
57- **Shared vocabulary**: early canonical terms, aliases, invented words,
58 genre terms with project-specific meanings, and terms the author wants
59 agents to avoid or distinguish
60 
61Present the draft and let the author adjust. Iterate until they're satisfied.
62 
63## Create the Files
64 
65Once approved:
66 
671. Write or update `CLAUDE.md` with the agreed content
682. Create the `kb/` directories referenced in CLAUDE.md
693. Create `kb/vocab.md` when the project has named concepts agents must use
70 consistently; create domain vocab files when a domain already has enough
71 distinct terms
724. Create `work/` with standard subdirectories (outline/, drafts/,
73 critique-reports/, brainstorm/)
745. Save any writing samples to `kb/samples/`
756. If samples were provided and the author wants style analysis, produce
76 initial style files in `kb/styles/`
77 
78## Existing Projects
79 
80If `CLAUDE.md` already has creative writing conventions, read it first and
81suggest updates rather than overwriting.
82 

Discussion