novel-track

Detect character state changes, track foreshadowing, and generate chapter summaries for web novels.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/cwjdong-design/novel --skill novel-track-cwjdong-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: novel-track
Source: https://github.com/cwjdong-design/novel/tree/main/novel-track
Command: npx skills add https://github.com/cwjdong-design/novel --skill novel-track-cwjdong-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-form web novels accumulate hundreds of chapters, making it easy to lose track of character states, forget planted foreshadowing, and miss overdue plot payoffs. This Skill automates post-chapter bookkeeping so story consistency is maintained without manual rereading. ## Core Features & Use Cases - Character State Tracking: Scans finalized chapter text across six dimensions (cultivation level, location, relationships, emotion, goals, items) and appends evidence-backed change records to each character card. - Foreshadowing Management: Auto-identifies new foreshadowing with confidence scores, confirms payoffs against the tracking table, and issues tiered overdue alerts with handling suggestions. - Chapter Synopsis Generation: Produces a 200-300 character summary per chapter and updates the storyline status and chapter plan files. - Use Case: After finishing chapter 42 of a xianxia novel, run this Skill to update Lin Ye's character card with his breakthrough, mark foreshadowing V07 as resolved, flag overdue thread V03, and log the chapter synopsis. ## Quick Start Use the novel-track skill to analyze the finalized text of chapter 42 of my book and update the character cards, foreshadowing table, and storyline status.

Frequently Asked Questions about novel-track

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

FAQPage Schema
How do I track character changes across novel chapters automatically?

This Skill scans each finalized chapter across six dimensions—cultivation, location, relationships, emotion, goals, and items—then appends evidence-backed change records to each character's Markdown card. It cross-validates detected changes against the chapter's plot outline and flags mismatches for manual review.

How to manage foreshadowing and plot payoff in long web novels?

The Skill auto-identifies potential foreshadowing using pattern rules with confidence scores, confirms payoffs by semantic matching against the tracking table, and records resolution method and quality. High-confidence items are registered automatically; medium-confidence ones are queued for human confirmation.

What happens when a foreshadowing thread is overdue?

Overdue threads are graded into four levels (mild, moderate, severe, critical) based on how many chapters past the planned payoff they are. Each alert includes a generated handling suggestion, such as natural insertion in the next chapter or re-evaluation of whether the thread should be revised or discarded.

Does this Skill write the novel text itself?

No. It only performs post-chapter bookkeeping: state tracking, foreshadowing updates, alerts, and synopsis generation. Drafting and polishing are handled by separate skills in the pipeline, and this Skill consumes their finalized output as input.

What files does the chapter tracking process update?

It updates character cards under the character library, the foreshadowing tracking table, the storyline status file with a 200-300 character synopsis, and marks the chapter as completed in the chapter plan. Inconsistencies are reported to the user rather than written directly to the error log.