graphify-novel

agent
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This tool is an AI-powered writing assistant designed for authors. It uses a knowledge graph to track characters, timelines, and world-building details across a manuscript, helping writers manage story bibles and review chapters for consistency.

Security Assessment
Overall Risk: Low. The light code audit found no dangerous patterns, hardcoded secrets, or requests for dangerous system permissions. Because it is designed to process your creative writing, it inherently accesses your local manuscript files. However, it functions as an offline structural tool. As long as your project folders do not contain sensitive personal files or hardcoded secrets within your fiction drafts, the tool poses no significant threat to your system.

Quality Assessment
The project is very new and currently has low visibility with only 5 GitHub stars, meaning it has not yet been widely tested by the developer community. However, it is off to a strong foundational start. It uses the standard MIT license, includes a clear description, and shows active maintenance with a repository push as recently as today. The documentation is thorough, detailing exactly how the tool reads and organizes text files, though users must rely on a secondary dependency (graphify) for it to function properly.

Verdict
Safe to use, but keep in mind that the tool is in its early stages and lacks widespread community validation.
SUMMARY

A knowledge-graph AI writing assistant - tracks characters, threads, and world-building across your full manuscript, scaffolds your story bible from a premise and reviews chapters for consistency.

README.md

graphify-novel: Writing assistant with knowledge graph

English | Tiếng Việt

Write. Don't track.

As your story grows, so does the overhead. Where was this character last seen, did you already establish that rule, which threads are still open? graphify-novel handles all of that so you can stay in the prose.

Give it a premise and it scaffolds your story bible. Feed it a chapter and it checks for contradictions, flags unresolved setups, and updates every character and thread automatically. Ask it a question and it traces connections across your full manuscript.

This skill uses graphify under the hood to extract a knowledge graph from your chapters and bible, mapping relationships between characters, locations, events, and themes across the full manuscript. This is what powers cross-chapter queries, structural hub detection, and the implicit connection hints in review.


Prerequisites

  • Any coding assistant (Copilot, Claude, etc)

  • graphify skill installed. If not already installed, the assistant will help you install it before continuing.


Installation

npx skills add Anshler/graphify-novel

Project structure

<your-project>/
  chapters/          ← manuscript files (preferably .txt or .md)
  draft/             ← work-in-progress (excluded from graph)
  static/            ← static files, images, etc (excluded from graph)
  bible/
    premise.md
    timeline.md
    characters/
    threads/
    world/
  graphify-out/      ← generated knowledge graph
  .graphifyignore

You can start with an empty project. But if it's an existing project, make sure your finished chapters are in chapters/, in-progress drafts are in draft/ and static files in static/.

If you already had an existing bible/story-tracking structure, it won't be compatible. Move them outside the project then retrofit them into the new structure after you initialize bible.


Usage

Run command from within your project folder in your AI assistant chat.

Initialize a bible from a premise (fresh start)

/graphify-novel init "A disgraced archivist discovers the empire's founding records were forged, and the proof is hidden in a vault only the guilty can open."

/graphify-novel init --from premise.txt

Initialize bible from existing chapters

/graphify-novel init --from-chapters

/graphify-novel init --from-chapters --batch 3

Scaffolds bible/, populates characters, threads, world files, and builds the initial knowledge graph.

--from-chapters is for porting an existing story. It sweeps all files in chapters/ in batches (default: 5) using sub-agents, each working in a fresh context so chapter count is not limited by the context window. Use --batch N to override the batch size.

Review a draft for consistency

/graphify-novel review ch03.md
/graphify-novel review ch03.md --intent "establish that Elara knows more than she admits"
/graphify-novel review --passage

Flags contradictions, continuity gaps, and thread opportunities. For better review, state your intent clearly.

This command never writes to the bible, findings are proposals only.

When ussing --passage the AI will prompt you to paste it in chat.

Update knowledge graph after writing

/graphify-novel update ch03.md
/graphify-novel update ch03.md --intent "establish that Elara knows more than she admits"
/graphify-novel update --lore "The Binding Pact was signed 40 years before the story begins"
/graphify-novel update --manual

Ideally, use it after you already reviewed the draft.

In --manual mode, the AI will hold conversation with you to identify the change.

Check story state before starting a chapter

/graphify-novel status

Shows open threads, character states, unresolved setups (Chekhov's guns), and structural hubs from the knowledge graph.

Manage plot threads

/graphify-novel thread new "The Heir's Secret"
/graphify-novel thread resolve binding-pact
/graphify-novel thread list

Query cross-chapter relationships

/graphify-novel query "how is Elara connected to the Obsidian Throne?"
/graphify-novel query "what do ch.3 and ch.8 have in common thematically?" --dfs
/graphify-novel path "Elara" "The Black Fort"

Commands

Command Description
/graphify-novel init "<premise>" scaffold bible from a premise
/graphify-novel init --from <file> scaffold bible from a premise file
/graphify-novel init --from-chapters [--batch N] build bible by sweeping existing chapters (default batch: 5)
/graphify-novel review [file] [--intent "..."] review a chapter/passage against the bible
/graphify-novel review --passage paste a passage inline (AI assistant will prompt)
/graphify-novel update [file] [--intent "..."] update bible from a chapter
/graphify-novel update --manual ["..."] interactive update
/graphify-novel update --lore "<lore>" add/edit bible lore
/graphify-novel query "<question>" relationship query across the full story graph
/graphify-novel query "<question>" --dfs depth-first — trace a specific path
/graphify-novel path "Node A" "Node B" shortest connection between two story elements
/graphify-novel status open threads, character states, unresolved items
/graphify-novel thread new "<name>" create a new plot thread
/graphify-novel thread resolve <slug> mark a thread resolved
/graphify-novel thread list list all threads with status

How it works

bible/ is the source of truth, structured state files that track what is currently true about each character, thread, and world element.

graphify-out/ is the relationship layer, a knowledge graph extracted from your full manuscript and bible. It surfaces implicit connections and structural patterns that direct file reads won't catch.

Neither replaces the other. The bible answers "where is Elara now?"; the graph answers "how did Elara and the Obsidian Throne end up connected?"

Tips

If you're unsure what command to use, just chat in natural language, ask the AI to look into the graphify-novel skill.

Yorumlar (0)

Sonuc bulunamadi