creative-research — Claude Code skill: sourced facts for fiction
This skill gathers grounded material for a story question: history, culture, daily detail, how a trade actually works. You get back a sourced report.
npx skills add haowjy/creative-writing-skills --skill creative-research -a claude-codeWhat creative-research does
Load the skill when a scene needs factual footing you don't have — period detail, cultural texture, accuracy in a narrow domain, or a look at how other writers handled similar material. You pass the question plus story context and get a report with citations.
The skill lays out where to look. Primary sources first: records, period documents, letters, diaries, court proceedings, field reports. Then reference works and published fiction in the same genre or period, mythology and folklore, wikis and encyclopedias, community discussion, author interviews, and practitioner accounts from medicine, law, the military, sailing, cooking, farming, forensics, finance. Place and culture get their own pass: geography, dialects, food, clothing, architecture, social customs, weather. It tells you to search for current sources instead of leaning on model recall, and to chase the specific over the category — not medieval weapons, but how a 14th-century English longbowman carried and maintained arrows on campaign.
The report has fixed sections: usable detail by topic, source notes with type and confidence, conflicts where sources disagree with both sides cited, contradictions with what your story currently assumes, and gaps. Story-fit calls stay with you. When the record is contested, the skill shows both versions rather than picking one — worth knowing before you build a scene on the disputed reading.
What it helps with
- find period detail you don't already know
- check how a doctor, lawyer or sailor actually works
- see how other authors handled similar material
- separate contested claims from settled facts
- flag where your draft contradicts the sources
Example prompts for the agent
- Research how a 14th-century English longbowman carried and maintained arrows on campaign. Context: a company marching through Scotland, POV is a young archer.
- I need daily-life detail: what a fishing family burned for heat and ate through a winter in northern Norway.
- How have other authors written courtroom interrogation scenes? Give examples and note where sources disagree.
How to install creative-research
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill creative-research -a claude-code2Manually: put the files in place
~/.claude/skills/creative-research/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/creative-research/
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill creative-research -a codex2Manually: put the files in place
.agents/skills/creative-research/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill creative-research -a cursor2Manually: put the files in place
.cursor/skills/creative-research/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install haowjy/creative-writing-skills creative-research2Manually: put the files in place
.github/skills/creative-research/SKILL.md1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill creative-research -a gemini-cli2Platform CLI
gemini skills install https://github.com/haowjy/creative-writing-skills --path skills/creative-researchManually: put the files in place
.devin/skills/creative-research/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill creative-research -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about creative-research
How do I install creative-research in Claude?
Run npx skills add haowjy/creative-writing-skills --skill creative-research -a claude-code. The skill lands at ~/.claude/skills/creative-research/SKILL.md.
What does creative-research do?
It gathers factual material for a story question and returns a sourced report: usable detail, source notes, conflicts between sources, contradictions with your draft, and gaps.
Which platforms support the skill?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each platform has its own install command and its own path to the skill file.
Source text
SKILL.md · Apache-2.0
--- name: creative-research type: reference description: > Load when a story needs factual grounding the writer doesn't have: historical detail, cultural texture, domain accuracy, or how other authors handled similar material. Pass the question and story context; returns a sourced report the writer can draw from. model-invocable: true --- # Creative Research Gather material the writer can use. Evaluate the evidence — source type, reliability, confidence, conflicts — but leave story-fit decisions to the writer. ## What to Look For **Primary sources.** Historical records, period documents, first-person accounts, letters, diaries, court proceedings, field reports. These carry detail and texture that secondary summaries flatten. **Reference works and published fiction.** Other novels, short stories, and narratives in the genre or period the author is working in. How have other writers handled similar material, settings, or problems? **History, mythology, and lore.** Real-world events, folklore, cultural traditions, religious texts, oral histories. Look for the specific and surprising over the general and expected. **Wikis and encyclopedias.** Fandom wikis for existing universes, Wikipedia for cultural and historical grounding, specialized references (weapons, ships, architecture, medicine, botany, legal systems). **Community discussion.** Writing forums, book reviews, reader reactions, genre convention debates. These surface what readers notice, what they forgive, and what breaks immersion. **Social media and interviews.** Author craft discussions, writing process threads, reader reception patterns, cultural commentary relevant to the story's setting or themes. **Domain expertise.** How specific fields actually work — medicine, law, military, sailing, cooking, farming, forensics, finance. The operational details that make fiction feel grounded. Look for practitioner accounts over textbook summaries. **Place and culture.** Geography, dialects, food, clothing, architecture, daily rhythms, social customs, weather patterns. The sensory and social texture of a setting. ## How to Search Search for current sources over training-data recall. Cultural understanding, historical scholarship, and community consensus shift. Practitioner accounts and experience reports are higher-signal than encyclopedia summaries. Surface conflicting information. When sources disagree on historical facts, cultural practices, or domain details, present both with citations. The writer needs to know where the record is contested. Follow the specific. "Medieval weapons" is a starting point; "how a 14th-century English longbowman carried and maintained arrows on campaign" is a finding. The writer needs concrete detail, not category overviews. ## Your Report Structure your report: - **Usable detail** — concrete findings organized by topic or question - **Source notes** — source type, reliability, and confidence for each finding - **Conflicts** — where sources disagree, with both sides cited - **Contradictions** — anything that conflicts with what the story currently assumes - **Gaps** — what you looked for and couldn't find Include citations and enough context that the writer can evaluate relevance without re-researching. Your final message is your report.
© haowjy · Apache-2.0 · haowjy/creative-writing-skills