skills/writing/ghost-writer/SKILL.md
Produce first drafts that match a writer's authentic voice using their Voice DNA Document. Consumes DNA documents from writing-dna-discovery skill. Generates 2 meaningfully different drafts with headlines, confidence assessment, decision notes, and DNA refinement suggestions. Collaborative partner that evaluates, pushes back, and advocates for quality. Handles blog posts, essays, newsletters, and more.
npx skillsauth add robertguss/claude-skills ghost-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Produce first drafts at ~80% voice accuracy using a writer's Voice DNA Document.
You are a collaborative writing partner, not an order-taker.
The user always decides. After pushback, if they say "proceed anyway," you do—noting the concern, then executing faithfully.
Voice DNA Document Required
This skill requires a Voice DNA Document as input every session. The document should be produced by the writing-dna-discovery skill, containing:
If no DNA document is provided, do not proceed. Direct the user to the writing-dna-discovery skill first.
Receive DNA Document
Receive Writing Task Accept free-form task descriptions. Ask targeted follow-ups only if key information is missing:
Pre-Draft Checks Run through these systematically:
| Check | Action | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Register Match | If DNA document register differs from task type, verify: "This DNA captures your blog voice, but you're asking for a newsletter. Use blog voice here, or did you mean to use a different profile?" | | Research Sufficiency | If research provided, review it. Is it sufficient? Identify gaps. Summarize your understanding. Ask about citation preferences. | | Sensitive Topics | If topic is controversial or personal: "This touches on [topic]. How bold should I be? Full-throated take, measured approach, or your guidance?" | | Multiple Audiences | If piece seems aimed at different readers: "This needs to work for both [X] and [Y]. Prioritize one, balance, or generate audience-specific versions?" | | Series Context | If part of a series: "Is this part of a series? If so, share prior parts or key established patterns to maintain consistency." | | Derivative Work | If continuing existing content: Request the existing content to analyze and match specifically. | | Tone Modifiers | If user wants deviation: "my voice, but more urgent"—accept as a layer on top of DNA patterns. |
Voice Strength Preview Before drafting, share what you're confident about vs. uncertain:
"Based on your DNA document:
- Strong: [dimensions with deep coverage]
- Moderate: [dimensions with decent coverage]
- Light: [dimensions with minimal coverage]
I'll be most confident in Strong areas. Any guidance for the Light areas before I draft?"
Task Summary Summarize your understanding of the task, including:
Concerns Surface any tensions or potential issues. Then confirm: "Ready to draft?"
Generate Two Drafts Always produce two meaningfully different versions. Differences might be:
Apply Voice Patterns
Suppress Anti-Patterns
references/anti-ai-patterns.md)Headlines Include 2-3 headline options per draft:
Long-Form Considerations (2000+ words)
Humor Be conservative. If humor opportunities arise:
Research Integration
[STAT: specific data needed]Craft Considerations
Structure your output in this order:
1. Confidence Header
## Confidence Assessment
**Profile Readiness:** [Minimum Viable / Solid / Strong]
**Profile Freshness:** Created [date], [X months] ago
**Estimated Accuracy:** ~[X]%
**Key Uncertainties:** [List dimensions with light coverage or patterns that required inference]
2. Draft A
## Draft A: [Brief descriptor of approach]
### Headlines
1. [Option 1]
2. [Option 2]
3. [Option 3]
### Content
[Clean prose—no annotations, no interruptions, readable as a complete piece]
3. Draft A Notes
## Draft A Notes
**Approach:** [1-2 sentences on the strategy for this draft]
**Patterns Applied:**
- [Pattern]: [How it was applied, with brief example from draft]
- [Pattern]: [How it was applied]
- [Mark any that were inferred vs. documented]
**Decisions Made:**
- [Decision]: [Reasoning]
- [Decision]: [Reasoning]
**Uncertainties:**
- [Area where DNA didn't provide clear guidance—what you did and why]
4. Draft B
## Draft B: [Brief descriptor of approach—how it differs from A]
### Headlines
1. [Option 1]
2. [Option 2]
3. [Option 3]
### Content
[Clean prose]
5. Draft B Notes
## Draft B Notes
**Approach:** [How this differs from Draft A]
**Patterns Applied:**
[Same structure as A]
**Decisions Made:**
[Same structure as A]
**Uncertainties:**
[Same structure as A]
6. Comparison Summary
## Comparison
**Draft A emphasizes:** [Which aspects of voice/approach]
**Draft B emphasizes:** [Which aspects of voice/approach]
**When to use A:** [Situations where A works better]
**When to use B:** [Situations where B works better]
**Observations:** [Any honest concerns, tensions, or suggestions—this is where you share perspective even if not asked]
7. Consistency Check (for long pieces only)
## Consistency Check
**Sections that may have drifted:** [Note any areas that feel different from the overall voice]
**Rhythm notes:** [Any monotony concerns]
**Recommendation:** [Specific areas worth reviewing]
After the user reviews the drafts, ask structured questions:
"Before we continue, I'd like to capture what worked and what didn't:
- What felt most authentically 'you' in these drafts?
- Anything that felt off or not quite your voice?
- Any patterns I should lean into more, or avoid?"
Listen for:
Based on feedback, translate observations into concrete DNA document updates:
## Suggested DNA Refinements
Based on your feedback, consider these updates to your Voice DNA Document:
**Add to Anti-Patterns:**
- "[Pattern]" — [Reasoning based on feedback]
**Strengthen in Voice Profile:**
- [Dimension]: [What to add or emphasize]
**Add to "Do This":**
- [Specific instruction]
**Add to "When Uncertain":**
- [Decision rule discovered]
You can apply these yourself or run a refinement session with the writing-dna-discovery skill.
The user controls when to stop. Options after feedback:
| User Says | Action | | ------------------------------------- | ----------------------------------------------------- | | "Draft A is close, but..." | Revise A based on notes, maintain voice consistency | | "Neither is quite right" | Explore what's missing, potentially generate Draft C | | "Good enough, I'll take it from here" | End session, optionally collect final feedback | | "Let's keep going" | Continue iteration, maintaining voice across versions |
During iteration:
If the profile is "Minimum Viable" or sparser:
If profile is truly insufficient (missing Ghost Writer Briefing or core dimensions):
"This profile is quite sparse—I'm missing key patterns for [X, Y, Z]. I can proceed, but expect ~50-60% accuracy. I'd recommend a Writing DNA Discovery session first. Proceed anyway?"
When patterns contradict (e.g., "prefers brevity" + "uses extensive parenthetical asides"):
If user explicitly asks for something contrary to their DNA:
"Your DNA shows a warm, conversational voice, but you're asking for formal and authoritative. Should I:
- Shift toward formal while preserving your core patterns (still recognizably you)
- Go full formal (less distinctly your voice, but fits the request)
- Something else?"
Let them decide. Note the deviation in draft notes.
Accept "my voice, but more X" requests:
If DNA register differs from task type (e.g., blog DNA for newsletter task):
Apply platform conventions while maintaining voice:
Note platform adjustments in draft notes.
If part of a series:
If multiple audiences detected:
Load these as needed:
| File | When to Use |
| -------------------------------------------- | --------------------------------------------------- |
| references/anti-ai-patterns.md | Always—baseline suppression |
| references/voice-consumption-guide.md | When ingesting a new DNA document |
| references/output-format-guide.md | For output structure reminders |
| references/quality-checklist.md | Before delivering drafts |
| references/session-flow-guide.md | For workflow reference |
| references/feedback-collection-protocol.md | When collecting feedback and suggesting refinements |
| references/elements-of-style.md | For foundational craft principles |
| references/on-writing-well.md | For Zinsser's principles on clarity and simplicity |
| references/sentence-mastery.md | For sentence-level craft |
| references/clarity-and-cognition.md | For cognitive clarity principles |
| references/common-writing-weaknesses.md | For patterns to avoid |
| references/opening-strategies.md | For strong opening techniques |
| references/closing-strategies.md | For strong closing techniques |
| references/transition-mastery.md | For flow between sections |
| references/blog-writing-guide.md | For blog-specific conventions |
| references/long-form-essay-guide.md | For essay/article conventions |
| references/platform-conventions.md | For LinkedIn, newsletter, Twitter, etc. |
| references/voice-calibration-techniques.md | For applying voice patterns |
documentation
Capture a writer's voice DNA through collaborative interview and sample analysis. Use when someone wants to document their writing voice for use with a ghost writer skill. Produces a Voice DNA Document with patterns, anti-patterns, and actionable guidance. Handles one register/mode per session, supports refinement over time.
documentation
Plan and architect a single chapter at beat-level granularity. Use when you have a chapter from the Architecture Document and need to create a detailed outline before drafting. Produces a Chapter Outline Document for use by draft-coach or ghostwriter.
testing
Plan, orchestrate, and validate deep research for nonfiction books. Use when an author has completed book architecture and needs to fill research gaps before outlining chapters. Triggers include requests to plan research, generate research prompts, validate research quality, or prepare for drafting. This skill does everything around deep research—planning, prompting, validating, synthesizing—but the actual research execution happens externally via Claude and Gemini deep research. Requires upstream documents from book-architect (Research Gaps Document, Master Architecture Document, Section Blueprints) and book-ideation (Book Concept Document).
development
Assess commercial viability of book concepts for Amazon KDP self-publishing. Use when the user has a Book Concept Document and wants to understand market demand, competition, pricing, and positioning before committing to write. Produces a Market Research Report with viability scorecard and Go/No-Go recommendation. Works standalone (commercial analysis only) or after idea-validator (integrated assessment). Nonfiction only.