A portable, voice-driven fiction-writing skill for Codex, Claude Code, DSH, and other hosts that load Markdown skills.
Topics: codex · claude-code · dsh · cross-platform · fiction-writing · novel-writing · voice-first · all-ages
This skill turns a spoken story impulse into prose while keeping the narrator's voice in control. It provides a compact workflow for:
- establishing a narrator voice anchor;
- drafting scenes in manageable passes;
- connecting sensory detail to action and consequence;
- letting physical conditions push the scene forward;
- alternating external events with inner experience;
- rewriting chapters while preserving continuity;
- tuning paragraph and sentence rhythm after the draft is complete.
The core writing behavior lives in voice-first-write/SKILL.md.
| Host | Compatibility | Use |
|---|---|---|
| OpenAI Codex | Ready | Load the voice-first-write/ folder as a skill. agents/openai.yaml supplies optional Codex UI metadata. |
| Claude Code | Ready | Copy the folder to .claude/skills/voice-first-write/; Claude Code reads the shared SKILL.md entry point. |
| DSH | Ready for Markdown skill loading | Import or copy the voice-first-write/ folder and use SKILL.md as the skill entry point. |
| Other Markdown skill hosts | Portable core | Use the same folder and treat agents/openai.yaml as optional metadata. |
The core uses Markdown instructions and natural-language interaction. Host-specific metadata remains optional, so the same writing method travels across environments.
Copy voice-first-write/ into the local skills directory used by your Codex installation. Keep agents/openai.yaml beside SKILL.md when Codex UI metadata is useful.
Copy the folder into a project or user skill directory:
.claude/skills/voice-first-write/SKILL.md
Import the voice-first-write/ folder through DSH's skill loader. The portable entry point is:
voice-first-write/SKILL.md
Use voice-first-write to continue this scene from the narrator's voice anchor.
Use voice-first-write to rewrite this chapter while preserving the established facts and tightening the rhythm.
voice-first-write/
├── SKILL.md # Shared writing workflow
└── agents/openai.yaml # Optional Codex UI metadata
The public bundle is a clean, reusable release package: it contains the skill instructions, license, and compatibility documentation. Personal paths, private logs, voice recordings, drafts, character files, and local configuration remain outside the repository.
MIT. See voice-first-write/LICENSE.