character-management

Create and update markdown character profiles with cross-referenced relationships for story projects.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill character-management-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: character-management
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/experimental/character-management
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill character-management-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Keeping character details, relationships, and timelines consistent across a long-form story project is difficult when information is scattered. This Skill structures every character as a markdown file with YAML frontmatter and maintains bidirectional cross-references across the project. ## Core Features & Use Cases - Character Profile Creation: Builds rich profiles covering appearance, personality, backstory, motivations, voice, and character arc using a standardized template. - Relationship Management: Maintains bidirectional relationship entries (parent/child, mentor/student, rival, etc.) with inverse pairs kept in sync between character files. - Family Trees & Cross-Referencing: Tracks family trees in a central index and links characters to locations, factions, artifacts, and plot arcs. - Use Case: While drafting a fantasy novel, ask the assistant to add a new antagonist; it creates the character file, links them to existing allies and locations, updates the registry index, and runs validation via the Story CLI. ## Quick Start Create a new character named Elena Voss as the antagonist of my story and link her as the rival of my protagonist.

Frequently Asked Questions about character-management

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

FAQPage Schema
How do I create a character profile for my story?

Provide the character's name and role (protagonist, antagonist, supporting, or minor), then build the profile through conversation covering appearance, personality, backstory, motivations, voice, and arc. The result is saved as a markdown file with YAML frontmatter in the characters/ directory.

How do I track character relationships in a writing project?

Relationships are stored in each character's frontmatter using typed entries like parent, rival, or mentor. Every relationship is bidirectional, so adding one to a character also adds the inverse type to the other character's file.

Does this skill require the Story CLI to work?

No, the Story CLI is optional. If it is unavailable, the skill falls back to the story-maintenance script or performs registry updates and backlink checks manually, though CLI access enables automated reindexing and validation.

Can I build a family tree for my novel characters?

Yes, family trees are maintained in the characters/_index.md file under a Family Trees section. Children are indented under parents, and marriages or partnerships are noted inline using the family relationship types.

What are the prerequisites for managing characters with this skill?

A story project must already exist, verified by the presence of story.md in the project root, typically created via the story-init skill. Character files are stored in the characters/ directory with a central _index.md registry.