skills/writing/writing-dna-discovery/SKILL.md
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.
npx skillsauth add robertguss/claude-skills writing-dna-discoveryInstall 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.
Capture the genetic code of a writer's voice through collaborative interview and sample analysis.
This is genuine intellectual partnership, not interrogation or extraction:
One Register Per Session Focus on a single mode: fiction prose, blog posts, technical writing, etc. Each register may have different voice characteristics. The user can create multiple DNA documents for different registers.
80% Approximation Goal The DNA document enables a ghost writer to produce first drafts at ~80% accuracy. The human adds the remaining 20%—the creative spark, situational judgment, and final polish. We're not replacing the writer; we're giving them a strong starting point.
Living Document The Voice DNA Document grows richer over time. Initial sessions capture the foundation; return sessions deepen, refine, and adapt as the writer's voice evolves.
Comprehensive Capability, Intelligent Application This skill has a full arsenal of voice dimensions but deploys them thoughtfully. Don't march through every dimension mechanically. Focus on what's most distinctive and relevant for this writer and register.
| Type | Signal | Approach | | ---------------------------- | -------------------------------------- | -------------------------------------------------- | | Initial Discovery | New user, no existing DNA doc | Full discovery flow | | Sample Addition | New samples + existing DNA doc | Analyze new samples, compare to profile, integrate | | Dimension Deep-Dive | "I want to go deeper on X" | Focus on specific dimension | | Refinement from Feedback | "The ghost writer keeps doing X wrong" | Convert feedback to anti-patterns | | Evolution Update | "My writing has changed" | Compare old vs. new, update profile | | New Register | "I want to add my fiction voice" | New discovery for different mode |
1. Initial Scan Read the sample(s). Identify the 3-5 most distinctive patterns that jump out. What makes this writing recognizably theirs?
2. Share Observations Present your findings: "Here's what I'm noticing about your writing..." Be specific. Give examples from their text.
3. Dialogue & Refinement The user confirms, adjusts, or adds context. "Actually, that's unusual for me—this piece was different because..." This dialogue refines your understanding.
4. Probe Deeper Ask targeted questions based on what emerged. If their sentence rhythm is distinctive, dig into that. If their tone is unusual, explore why.
5. Synthesize Update the DNA document at meaningful milestones, not constantly. Capture patterns, examples, and the reasoning behind choices.
Beyond standard Q&A, use these to surface voice:
Comparative Choices
"Would you write 'He walked into the room' or 'He stepped into the room' or something else?"
Contrastive Examples
"This reads more Hemingway than David Foster Wallace. Where do you see yourself on that spectrum?"
Elimination Exercises
"Which of these words would you NEVER use: utilize, leverage, facilitate, synergize?"
Completion Prompts Give a sentence starter; see how they naturally finish it.
"The problem with most writing advice is..."
Rewrite Exercises Show generic AI-sounding text; ask them to rewrite it in their voice.
"Transform this: 'This methodology provides a comprehensive framework for understanding the complex dynamics at play.'"
These should be addressed in every discovery session:
| Dimension | What It Captures | | --------------------------- | -------------------------------------------------------------------------- | | Sentence Rhythm | Length variation, internal structure, emphasis placement, cadence | | Punctuation Personality | Em-dashes, semicolons, parentheses, comma density, exclamations | | Word Choice | Vocabulary level, Anglo-Saxon vs. Latinate, favorites, avoided words | | Tone & Temperature | Warm/cool, formal/casual, confident/hedging, measured/enthusiastic | | Reader Relationship | First person presence, direct address, assumed knowledge, authority stance |
Explore these when they emerge as distinctive or when going deeper:
| Dimension | What It Captures | | ----------------------- | ------------------------------------------------------------------------- | | Opening Moves | How they begin pieces: in media res, hooks, questions, scene-setting | | Closing Moves | How they end: callbacks, questions, definitive statements, quiet landings | | Structural Patterns | Paragraph construction, transitions, section organization | | Confidence/Hedging | "Perhaps" vs. direct assertion, qualifier density, uncertainty handling | | Humor Approach | If present: dry wit, self-deprecation, wordplay, sarcasm, or absent | | Signature Elements | Distinctive moves, pet phrases, characteristic tics |
Critical for the ghost writer skill:
references/anti-ai-patterns.md)Surface these based on the register being captured:
Fiction:
Non-Fiction/Essays:
Blog/Casual:
Technical:
Don't just respond—actively contribute:
Pattern Spotting
"I notice you never start sentences with 'I' in these posts, but you do frequently in personal essays. Is that intentional, or am I seeing two different registers?"
Contradiction Flagging
"These two samples show different approaches to paragraph length. Your essay has long, flowing paragraphs while your blog posts are choppy. Which is more 'you,' or are these genuinely different modes?"
Gap Identification
"We have a solid handle on your sentence patterns and tone, but I don't have a sense of how you handle humor. Do you use it? If so, what kind?"
Strength Highlighting
"Your most distinctive feature is how you end paragraphs—almost always with a concrete image rather than an abstraction. The ghost writer should definitely preserve this."
AI-Pattern Warnings
"I notice you used 'it's important to note' in this piece—is that typical for you, or was this edited by someone else? I ask because it's a common AI pattern we'd want to exclude."
Ghost writer accuracy: ~60-70%
Ghost writer accuracy: ~75-85%
Ghost writer accuracy: ~85-90%
Communicate readiness clearly:
"This profile is solid enough for first drafts. The ghost writer should capture your voice about 80% of the time. Want to go deeper, or is this good for now?"
For New Users:
For Returning Users:
"Between now and next time, notice a piece of writing—yours or someone else's—that makes you think 'that's exactly how I would/wouldn't say that.' Bring it back."
Sometimes users want the ghost writer to write like they wish they wrote, not how they actually write.
"I'm noticing a gap between how you describe your ideal voice and what I see in these samples. Do you want me to capture how you currently write, how you aspire to write, or both?"
Document which is which. The ghost writer can either match them or help them move toward a target.
If the user has only one short piece:
If samples show conflicting patterns:
If samples may have been edited by others:
Use assets/templates/voice-dna-template.md for the living Voice DNA Document.
Load these as needed, not upfront:
| File | When to Use |
| --------------------------------------- | -------------------------------------------------- |
| references/anti-ai-patterns.md | When discussing what the ghost writer should avoid |
| references/voice-dimension-catalog.md | For deep dives into specific dimensions |
| references/interview-question-bank.md | For structured discovery questions |
| references/sample-analysis-guide.md | When systematically analyzing samples |
| references/dna-document-examples.md | To show what "good" profiles look like |
| references/failure-patterns.md | When something seems off or profile feels weak |
testing
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.
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.