story-review

Identify narrative inconsistencies in story documents, NPCs, quests, and designs during PR reviews.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/gcko/pendulum-of-despair --skill story-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-review
Source: https://github.com/gcko/pendulum-of-despair/tree/main/.claude/skills/story-review
Command: npx skills add https://github.com/gcko/pendulum-of-despair --skill story-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps reviewers validate narrative content changes across story documents, ASCII layouts, NPC definitions, quest lines, and game logic narratives, and supports posting results to GitHub or inline review for local work.

Core Features & Use Cases

  • PR-based narrative review: posts review results to GitHub for PRs that add or modify story content.
  • Local review: outputs inline results for uncommitted changes without posting anywhere.
  • Mode detection: automatically switches between PR mode and local mode based on provided arguments.
  • Cross-document validation: checks for naming consistency, cross-references, act progression, and NPC/location/story coherence.

Quick Start

Invoke with a PR URL to post a review to GitHub, or run with no argument to review local changes inline.

Frequently Asked Questions about story-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check narrative content for story consistency in game design documents?

To validate narrative content for story consistency, review PRs that modify story documents, NPC definitions, and quests to identify cross-document inconsistencies. This enforces frontmatter presence, naming consistency, act progression logic, pronoun alignment, and bidirectional references.

Can I review uncommitted local narrative changes for NPC and quest definitions without posting to GitHub?

Yes, you can review uncommitted local narrative changes for NPC and quest definitions without posting to GitHub. Running the review locally automatically switches to local mode, outputting validation results inline rather than publishing them to a remote repository.

What specific validation checks are applied to story documents and city/dungeon designs during a review?

Validation checks applied to story documents and city/dungeon designs include enforcing frontmatter presence, naming consistency, act progression logic, pronoun alignment, and bidirectional references. This cross-document validation ensures story, NPC, and location coherence.

How do I post automated narrative review results directly to a GitHub PR?

To post automated narrative review results directly to a GitHub PR, invoke the review process using a PR URL. This activates PR mode, automatically validating narrative content changes and posting the consistency check results as feedback to the GitHub pull request.

Does story content validation work for both published GitHub PRs and local unpushed changes?

Yes, story content validation works for both published GitHub PRs and local unpushed changes. The system features automatic mode detection, switching between posting review results to GitHub or displaying inline results based on whether a PR URL is provided.

When should I use automated cross-document validation for narrative content?

You should use automated cross-document validation for narrative content when modifying story documents, NPC definitions, quests, or city/dungeon designs. It prevents broken bidirectional references and maintains act progression logic before merging narrative changes.