Story Multi-Perspective Review
zenstory-ai/oh-story-claudecode
Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.
Diagnose what any story needs regardless of its current state.
Install Story Sense
$ npx skills add jwynia/agent-skills --skill story-sense -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jwynia/agent-skills story-sense --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/creative/fiction/core/story-sense .claude/skills/story-sense && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "story-sense" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/core/story-sense into .claude/skills/story-sense/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "story-sense", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/core/story-senseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jwynia/agent-skills --skill story-sense -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jwynia/agent-skills story-sense --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/creative/fiction/core/story-sense .agents/skills/story-sense && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "story-sense" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/core/story-sense into .agents/skills/story-sense/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "story-sense", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jwynia/agent-skills --skill story-sense -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jwynia/agent-skills story-sense --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/creative/fiction/core/story-sense .cursor/skills/story-sense && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "story-sense" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/core/story-sense into .cursor/skills/story-sense/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "story-sense", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jwynia/agent-skills.git --path skills/creative/fiction/core/story-sense--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jwynia/agent-skills --skill story-sense -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jwynia/agent-skills story-sense --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/creative/fiction/core/story-sense .gemini/skills/story-sense && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "story-sense" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/core/story-sense into .gemini/skills/story-sense/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "story-sense", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jwynia/agent-skills story-senseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jwynia/agent-skills --skill story-sense -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/creative/fiction/core/story-sense .github/skills/story-sense && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "story-sense" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/core/story-sense into .github/skills/story-sense/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "story-sense", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jwynia/agent-skills --skill story-sense -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jwynia/agent-skills story-sense --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/creative/fiction/core/story-sense .opencode/skills/story-sense && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "story-sense" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/core/story-sense into .opencode/skills/story-sense/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "story-sense", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
story-sense- GitHub stars
- 170
- Token cost
- ~1.4k tokens
- SKILL.md length
- 487 words
- Files
- 5 (incl. scripts)
- Skills in repo
- 111
- Repo updated
- First seen
- Licence
- MIT
At a glance
Diagnose what any story needs regardless of its current state.
- Works in 6 steps: Listen for symptoms - What are they… → Ask clarifying questions - Get specific… → Identify the state - Match symptoms to… → …
- Tasks that involve Creative writing and fiction
- SKILL.md covers When to Use This Skill, Core Principle, The Story States and Decision Tree, plus 4 more sections
- Runs TypeScript scripts from its folder; calls deno
What it does
Story Sense is an agent skill from jwynia/agent-skills. Diagnose what any story needs regardless of its current state. This skill should be used when a writer is stuck, evaluating story problems, when narrative feels broken, or when someone asks 'what's wrong with my story?'. Keywords: story, diagnosis, stuck, narrative, plot, character, worldbuilding, revision.
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `data/functions-forms.json`, `data/genre-elements.json` and `scripts/entropy.ts`). Compatibility notes: Works with any fiction format. Entry point for fiction diagnostics.
It sits in Writing & Content, covering Creative writing and fiction. The licence is MIT.
When your agent uses it
- Tasks that involve Creative writing and fiction
Example prompts
- “s wrong with my story?”
- “/story-sense”
Requirements
- Node.js
- Compatibility (from SKILL.md): Works with any fiction format. Entry point for fiction diagnostics.
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Listen for symptoms - What are they describing as the problem?
- Ask clarifying questions - Get specific about where they're stuck
- Identify the state - Match symptoms to state list
- Name the diagnosis - Explain what you're seeing
- Recommend intervention - Point to specific skill
- Offer next steps - What should they try first?
What it can do on your machine
Read from SKILL.md and the folder at commit e02ec7e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (TypeScript), which the agent can run.
Shell commands in SKILL.md call:
deno
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Works with any fiction format. Entry point for fiction diagnostics.
From compatibility in the SKILL.md frontmatter.
Context cost
Story Sense loads about 1.4k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 487 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from jwynia/agent-skills at commit e02ec7e, republished under its MIT licence (© jwynia). 487 words, ~1,364 tokens.
Download SKILL.mdSave it as
.claude/skills/story-sense/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.- name
- story-sense
- description
- Diagnose what any story needs regardless of its current state. This skill should be used when a writer is stuck, evaluating story problems, when narrative feels broken, or when someone asks 'what's wrong with my story?'. Keywords: story, diagnosis, stuck, narrative, plot, character, worldbuilding, revision.
- compatibility
- Works with any fiction format. Entry point for fiction diagnostics.
- license
- MIT
- metadata.author
- jwynia
- metadata.version
- 1.0
- metadata.type
- diagnostic
- metadata.mode
- diagnostic
- metadata.domain
- fiction
Story Sense: Diagnostic Skill
Identify what state a story is in and what it needs to move forward. This is not a linear process but a diagnostic model: Assess → Diagnose → Intervene → Reassess.
When to Use This Skill
Use this skill when:
- Writer is stuck and doesn't know why
- Story feels broken but root cause unclear
- Need to evaluate story problems systematically
- Someone asks "what's wrong with my story?"
Do NOT use this skill when:
- Writer wants you to write the story (use story-collaborator)
- Writer wants coaching questions only (use story-coach)
- Publishing/marketing questions (use book-marketing)
Core Principle
Story Sense is the ability to know what any story needs, regardless of its current state or intended medium.
There's no such thing as "stuck." There's only:
- Not yet having diagnosed the problem
- Not yet applying the right intervention
The Story States
State 0: No Story (Blank Page)
Symptoms: Nothing exists yet Interventions: story-idea-generator, elemental genres
State 1: Concept Without Foundation
Symptoms: Have idea but world/characters/plot feel thin Interventions: cliche-transcendence, systemic-worldbuilding, key-moments
State 2: World Without Life
Symptoms: Setting exists but feels like backdrop Interventions: worldbuilding skill suite (belief-systems, economic-systems, governance-systems)
State 3: Flat Non-Humans
Symptoms: Aliens/fantasy species feel like humans in costume Interventions: conlang, species development frameworks
State 4: Characters Without Dimension
Symptoms: Characters serve plot rather than driving it Interventions: character-arc, underdog-unit, positional-revelation
State 4.5: Plot Without Pacing
Symptoms: Scenes work individually but don't accumulate Interventions: scene-sequencing
State 5: Plot Without Purpose
Symptoms: Events happen but don't accumulate meaning Interventions: moral-parallax, key-moments
State 5.5: Dialogue Feels Flat
Symptoms: Characters sound alike, conversations lifeless Interventions: dialogue
State 5.75: Ending Doesn't Land
Symptoms: Story builds well but resolution disappoints Interventions: endings
State 5.85: Draft Not Progressing
Symptoms: Planning done but draft isn't happening Interventions: drafting
Show full SKILL.md (196 more words)Show less
State 5.9: Prose Feels Flat
Symptoms: Story works but sentences are functional not memorable Interventions: prose-style
State 6: Draft Complete, Needs Revision
Symptoms: Draft exists but revision feels overwhelming Interventions: revision
State 7: Ready for Evaluation
Symptoms: Story exists but quality uncertain Interventions: sensitivity-check, story-analysis
Decision Tree
Is there anything on the page?
├── NO → story-idea-generator
└── YES → What's the problem?
├── Feels generic → cliche-transcendence
├── World feels thin → worldbuilding
├── Non-humans feel fake → conlang
├── Characters flat → character-arc
├── Pacing off → scene-sequencing
├── Dialogue wooden → dialogue
├── Ending weak → endings
├── Meaning unclear → moral-parallax
├── Draft not progressing → drafting
├── Prose flat → prose-style
└── Draft needs revision → revisionDiagnostic Process
- Listen for symptoms - What are they describing as the problem?
- Ask clarifying questions - Get specific about where they're stuck
- Identify the state - Match symptoms to state list
- Name the diagnosis - Explain what you're seeing
- Recommend intervention - Point to specific skill
- Offer next steps - What should they try first?
Available Scripts
entropy.ts
Injects creative randomness from curated lists.
deno run --allow-read scripts/entropy.ts lies
deno run --allow-read scripts/entropy.ts disasters --count 3
deno run --allow-read scripts/entropy.ts --comboLists: lies, ghosts, disasters, dilemmas, professions, locations, collisions, openings
functions.ts
Generates characters from abstract story functions.
deno run --allow-read scripts/functions.ts
deno run --allow-read scripts/functions.ts --setting scifi
deno run --allow-read scripts/functions.ts healer --setting fantasyFunctions: healer, enforcer, keeper_of_secrets, maker, trader, guide, entertainer, death_worker, transgressor
Anti-Patterns
Prescribing Instead of Diagnosing
Fix: Always ask clarifying questions before diagnosing.
Framework Overload
Fix: Recommend one intervention. Expand after reassessment.
Ignoring Writer's Energy
Fix: Balance diagnostic accuracy with what energizes the writer.
Treating Structure as Story
Fix: Keep asking "Does this feel right?" alongside structural diagnosis.
Related Skills
Routes to all fiction skills based on diagnosed state.
© jwynia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 4 other files (scripts) in skills/creative/fiction/core/story-sense of jwynia/agent-skills.
- SKILL.md
- data/functions-forms.json
- data/genre-elements.json
- scripts/entropy.ts
- scripts/functions.ts
Open the folder on GitHubat commit e02ec7e
Compare with similar skills
Story Sense next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Story Sense this skilljwynia/agent-skills | 170 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode | 7.4k | 3 repos | ~3k | Automated safety check: Pass | MIT | |
| Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode | 7.4k | 2 repos | ~1.2k | Automated safety check: Pass | MIT | |
| InkOS Creative HarnessNarcooo/inkos | 10k | 1 repos | ~1.1k | Automated safety check: Pass | AGPL-3.0 | |
| Novel Arteternityspring/shuohao-skills | 4.3k | — | ~1.1k | Automated safety check: Notes | Apache-2.0 | |
| SepiaNanako0129/sepia | 3.1k | — | ~3.6k | Automated safety check: Pass | MIT |
Similar skills
Short Web Fiction Trend Scan
zenstory-ai/oh-story-claudecode
Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.
InkOS Creative Harness
Narcooo/inkos
Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.
Novel Art
eternityspring/shuohao-skills
给 AI 短剧出美术设定集（场景 + 叙事道具）：场景的设计意图、一致性锚点、光照时段变体、 空景提示词；道具的戏剧功能、状态变体、尺度参照、白底无手提示词。
Sepia
Nanako0129/sepia
Make AI-generated writing read as human-written, in fiction and in professional prose.
Story Toolbox Router
zenstory-ai/oh-story-claudecode
Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.
More from jwynia/agent-skills
All 111 skills in this repoDevcontainer
jwynia/agent-skills
Diagnose devcontainer configuration problems and guide development environment setup.
Frontend Design
jwynia/agent-skills
Create distinctive, production-grade frontend interfaces with high design quality.
Gitea Workflow
jwynia/agent-skills
Orchestrate agile development workflows for Gitea repositories using the tea CLI.
Godot Asset Generator
jwynia/agent-skills
Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.
Mastra Hono
jwynia/agent-skills
Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers.
PPTX Generator
jwynia/agent-skills
Create and manipulate PowerPoint PPTX files programmatically.
Related
Categories
Questions about Story Sense
What does Story Sense do?
Diagnose what any story needs regardless of its current state. Story Sense is an agent skill from jwynia/agent-skills. Diagnose what any story needs regardless of its current state.
When should I use Story Sense?
Story Sense fits situations like: tasks that involve Creative writing and fiction.
How do I install Story Sense in Claude Code?
Run `npx skills add jwynia/agent-skills --skill story-sense -a claude-code`. Or copy the skill folder (skills/creative/fiction/core/story-sense in jwynia/agent-skills) into .claude/skills/story-sense in your project. Claude Code loads it when a task matches its description.
How do I install Story Sense in Codex?
Run `npx skills add jwynia/agent-skills --skill story-sense -a codex`. Or copy the skill folder (skills/creative/fiction/core/story-sense in jwynia/agent-skills) into .agents/skills/story-sense in your project. Codex loads it when a task matches its description.
Can I use Story Sense in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jwynia/agent-skills --skill story-sense -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/story-sense, .gemini/skills/story-sense, .github/skills/story-sense and .opencode/skills/story-sense in your project.
What does Story Sense need to run?
Going by SKILL.md and its folder, Story Sense needs TypeScript for the scripts in its folder and the command-line tools its instructions call (deno). Our summary lists: Node.js. Compatibility (from SKILL.md): Works with any fiction format. Entry point for fiction diagnostics..
Does Story Sense access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Story Sense safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Story Sense use?
Story Sense is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Story Sense use?
About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Story Sense?
Skills that share tags, products or a category with Story Sense: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Story Sense?
jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 170 GitHub stars. The repository holds 111 skills in this directory. The repository was last updated on February 24, 2026.
Source: jwynia/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.