✨ Story Skills
End-to-end story writing powered by markdown and AI agents.
Manage characters, build worlds, structure plots, and write chapters — all as structured markdown files with YAML frontmatter.
Works with Claude Code, GitHub Copilot, Cursor, Windsurf, Gemini CLI, OpenAI Codex, OpenCode, and any agent that supports the
SKILL.mdstandard.
🚀 Quick Start
# Claude Code — install in two commands
/plugin marketplace add danjdewhurst/story-skills
/plugin install story-skills@story-skills
Then just say "Start a new story" and the agent takes it from there.
📦 Installation
Claude Code
# Add the marketplace
/plugin marketplace add danjdewhurst/story-skills
# Install the plugin
/plugin install story-skills@story-skills
GitHub Copilot (VS Code)
VS Code with Copilot discovers skills from multiple directories:
git clone https://github.com/danjdewhurst/story-skills.git
# Copy skills to your project (any of these work)
cp -r story-skills/skills/* .github/skills/
cp -r story-skills/skills/* .agents/skills/
# Or install globally
cp -r story-skills/skills/* ~/.copilot/skills/
Skills auto-activate when your request matches a skill's description or can be invoked manually.
Cursor
Cursor supports the SKILL.md standard:
git clone https://github.com/danjdewhurst/story-skills.git
cp -r story-skills/skills/* .agents/skills/
Windsurf
Windsurf discovers skills from workspace and global directories:
git clone https://github.com/danjdewhurst/story-skills.git
# Copy skills to your project
cp -r story-skills/skills/* .windsurf/skills/
# Or install globally
cp -r story-skills/skills/* ~/.codeium/windsurf/skills/
Cascade auto-invokes skills when your request matches a skill's description, or use @skill-name to invoke manually.
Gemini CLI
Gemini CLI supports the same SKILL.md format via the Agent Skills standard:
# Install all skills globally
gemini skills install https://github.com/danjdewhurst/story-skills.git
# Or install a specific skill
gemini skills install https://github.com/danjdewhurst/story-skills.git --path skills/story-init
gemini skills install https://github.com/danjdewhurst/story-skills.git --path skills/character-management
gemini skills install https://github.com/danjdewhurst/story-skills.git --path skills/worldbuilding
gemini skills install https://github.com/danjdewhurst/story-skills.git --path skills/plot-structure
gemini skills install https://github.com/danjdewhurst/story-skills.git --path skills/chapter-writing
# Or link locally after cloning
git clone https://github.com/danjdewhurst/story-skills.git
gemini skills link story-skills/skills
Gemini will auto-discover the skills and activate them when your request matches a skill's description.
Codex (OpenAI)
Codex uses the same SKILL.md format via the Agent Skills standard:
git clone https://github.com/danjdewhurst/story-skills.git
# Install to your user skills (available across all projects)
cp -r story-skills/skills/* ~/.agents/skills/
# Or install to a specific repo
cp -r story-skills/skills/* .agents/skills/
Codex detects new skills automatically.
OpenCode
The skills use the same SKILL.md format that OpenCode supports natively:
git clone https://github.com/danjdewhurst/story-skills.git
# Copy skills to your project
cp -r story-skills/skills/* .opencode/skills/
# Or install globally
cp -r story-skills/skills/* ~/.config/opencode/skills/
OpenCode also searches .claude/skills/ paths, so project-level Claude skills are automatically discovered.
Other platforms
These skills follow the open Agent Skills standard (SKILL.md with YAML frontmatter). They work with any compatible agent — just copy the skill folders to your agent's skills directory.
For non-agent use: