Agent skill

Character Relationships

by VanGong1999 in VanGong1999/screen-creative-skills

Analyze story character relationships, identify types, characteristics, and development changes.

MITAuto-check passed

Install Character Relationships

skills CLI
$ npx skills add VanGong1999/screen-creative-skills --skill character-relationships -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install VanGong1999/screen-creative-skills character-relationships --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/VanGong1999/screen-creative-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/english-version/category/character-analysis/character-relationships .claude/skills/character-relationships && rm -rf skills-src

Use ~/.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/

Facts

Skill name
character-relationships
GitHub stars
446
Token cost
~1.3k tokens
SKILL.md length
275 words
Files
3 (incl. references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Analyze story character relationships, identify types, characteristics, and development changes.

  • Works in 5 steps: Identify Characters: Identify all main… → Analyze Relationships: Analyze… → Classify and Organize: Classify and… → …
  • SKILL.md covers Functionality, Use Cases, Core Steps and Input Requirements, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Character Relationships is an agent skill from VanGong1999/screen-creative-skills. Analyze story character relationships, identify types, characteristics, and development changes. Suitable for deeply understanding character relationship networks, analyzing the plot-driving role of relationships, and providing relationship support for plot design

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/examples.md` and `references/guide.md`). Compatibility notes: Claude Code 1.0+

The repository describes itself as: Skills for Film and Television Creation Agents|31 个影视创作评估策划Agent Skills|AI影视自动化工作流|竖屏短剧长剧IP改编|情节题材提炼|剧本小说IP创作策划评估|人物小传|拉片人物剧集故事五元素分析|大纲生成|. The licence is MIT.

Example prompts

  • “/character-relationships”

Requirements

  • Compatibility (from SKILL.md): Claude Code 1.0+
  • Pre-approved tools (allowed-tools): Read

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify Characters: Identify all main characters in the story.
  2. Analyze Relationships: Analyze relationship types and characteristics between characters.
  3. Classify and Organize: Classify and organize character relationships.
  4. Describe Characteristics: Describe specific characteristics of character relationships.
  5. Analyze Changes: Analyze the development process and changes of character relationships.

What it can do on your machine

Read from SKILL.md and the folder at commit 6ced54f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

    Claude Code 1.0+

    From compatibility in the SKILL.md frontmatter.

Context cost

Character Relationships loads about 1.3k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 275 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.9k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from VanGong1999/screen-creative-skills at commit 6ced54f, republished under its MIT licence (© VanGong1999). 275 words, ~1,287 tokens.

Download SKILL.mdSave it as .claude/skills/character-relationships/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
character-relationships
description
Analyze story character relationships, identify types, characteristics, and development changes. Suitable for deeply understanding character relationship networks, analyzing the plot-driving role of relationships, and providing relationship support for plot design
allowed-tools
Read
compatibility
Claude Code 1.0+
category
character-analysis
version
2.1.0
last_updated
2026-01-11
license
MIT
maintainer
Gong Fan
model
opus

Character Relationship Analysis Expert

Functionality

Analyze relationships between characters in stories, identify relationship types and characteristics, and describe their development process and changes.

Use Cases

  • Deeply understand character relationship networks in stories.
  • Analyze the plot-driving role of character relationships.
  • Provide relationship perspectives for character shaping.
  • Provide relationship support for plot design.

Core Steps

  1. Identify Characters: Identify all main characters in the story.
  2. Analyze Relationships: Analyze relationship types and characteristics between characters.
  3. Classify and Organize: Classify and organize character relationships.
  4. Describe Characteristics: Describe specific characteristics of character relationships.
  5. Analyze Changes: Analyze the development process and changes of character relationships.

Input Requirements

  • Complete story text containing character relationship information.
  • Can specify character relationships to be analyzed (optional).
  • Recommended text length: 500+ words.

Output Format

[Character Relationship Analysis]

I. Relationship Network Overview
- Main Character List: [Character List]
- Relationship Type Statistics: [Number of Each Type of Relationship]

II. Main Character Relationship Details

[Relationship 1: Character A ↔ Character B]
- Relationship Type: [Family/Friendship/Love/Hostile/Mentor-Disciple/Colleague, etc.]
- Relationship Characteristics: [Description of Relationship Characteristics]
- Relationship Development Process: [How the Relationship Develops and Changes]
- Reasons for Relationship Change: [Causes Leading to Changes]
- Impact on Story: [How It Affects Plot Development]

[Relationship 2: Character A ↔ Character C]
...

III. Character Relationship Map
- Central Character: [Who is the Center of Relationships]
- Secondary Characters: [Minor Character Relationships]
- Peripheral Characters: [Peripheral Character Relationships]

IV. Character Relationship Change Trajectory
- Initial State: [Relationship at the Beginning of the Story]
- Intermediate Changes: [How the Relationship Changes]
- Final State: [Relationship at the End of the Story]

Constraints

  • Strictly analyze based on provided story text, do not create on your own.
  • Ensure accuracy and completeness of character relationship identification.
  • Describe character relationship development process with clear logic and organization.

Examples

Please refer to {baseDir}/references/examples.md for detailed examples. This file contains character relationship analysis reports and analysis instructions for various story types (such as romance, workplace, family, etc.).

Detailed Documentation

See {baseDir}/references/ directory for more documentation:

  • guide.md - Complete character relationship analysis guide
  • examples.md - More analysis examples for different scenarios

Version History

VersionDateChanges
2.1.02026-01-11Optimized description field to be more concise and comply with imperative language specifications; changed model to opus; optimized descriptions of functionality, use cases, core steps, input requirements, and output format to comply with imperative language specifications; added constraints, examples, and detailed documentation sections.
2.0.02026-01-11Refactored according to official specifications; added allowed-tools (Read) and model fields
1.0.02026-01-10Initial version

© VanGong1999, 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 2 other files (references) in english-version/category/character-analysis/character-relationships of VanGong1999/screen-creative-skills.

  • SKILL.md
  • references/examples.md
  • references/guide.md

Open the folder on GitHubat commit 6ced54f

Compare with similar skills

Character Relationships 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.

Character Relationships compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Character Relationships this skillVanGong1999/screen-creative-skills446—~1.3kAutomated safety check: PassMIT
Rust Path Typesopeninterpreter/openinterpreter69k2 repos~605Automated safety check: PassApache-2.0
Python Type Safetywshobson/agents40k—~1.4kAutomated safety check: PassMIT
Pyrefly Type Coveragepytorch/pytorch104k—~3kAutomated safety check: PassCustom licence
Game Story World Characterhashgraph-online/awesome-codex-plugins1.3k—~546Automated safety check: PassMIT
Story ReadinessDonchitos/Claude-Code-Game-Studios26k—~6.9kAutomated safety check: PassMIT

Similar skills

  • Rust Path Types

    openinterpreter/openinterpreter

    Rules for choosing Rust types for filesystem paths in new Codex code, covering protocol types, internal use and model tool arguments.

    69k GitHub starsUsed in 2 repos~605 tokens
    DevelopmentAuto-check passed
  • Python Type Safety

    wshobson/agents

    Python type safety with type hints, generics, protocols, and strict type checking.

    40k GitHub stars~1.4k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Pyrefly Type Coverage

    pytorch/pytorch

    Migrate a file to use stricter Pyrefly type checking with annotations required for all functions, classes, and attributes.

    104k GitHub stars~3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Game Story World Character

    hashgraph-online/awesome-codex-plugins

    Design or evaluate game story, world, characters, spaces, presence, aesthetics, and indirect control.

    1.3k GitHub stars~546 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Story Readiness

    Donchitos/Claude-Code-Game-Studios

    Is a story implementation-ready?. An agent skill from Donchitos/Claude-Code-Game-Studios.

    26k GitHub stars~6.9k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Job Stories

    phuryn/pm-skills

    Turns a feature into job stories in the When, I want to, so I can format, each with six to eight acceptance criteria tied to the user's situation and outcome.

    27k GitHub stars~743 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from VanGong1999/screen-creative-skills

All 62 skills in this repo
  • Drama Creator

    VanGong1999/screen-creative-skills

    Create vertical short drama scripts covering macro construction, episode writing, precise optimization, and creative ideation using Emotional Spring Theory.

    446 GitHub stars~2.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Drama Workflow

    VanGong1999/screen-creative-skills

    Orchestrate the full plot-point dramatic function analysis pipeline — text preprocessing, parallel segment analysis, result integration, and report generation — for long-form story content.

    446 GitHub stars~850 tokensUpdated 4 mo ago
    Auto-check passed
  • Novel Evaluator

    VanGong1999/screen-creative-skills

    Evaluate and score story text across market potential, innovation attributes, and content highlights dimensions, producing structured scoring reports with development recommendations.

    446 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Script Evaluator

    VanGong1999/screen-creative-skills

    Evaluate film and TV scripts across ideological, artistic, and entertainment value dimensions, producing structured scoring reports with follow-up recommendations.

    446 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Story Five Elements

    VanGong1999/screen-creative-skills

    Analyze five core story elements — genre type, story summary, character biographies, character relationships, and major plot points — producing a structured comprehensive report with optional mind…

    446 GitHub stars~781 tokensUpdated 4 mo ago
    Auto-check passed
  • Character Profile

    VanGong1999/screen-creative-skills

    基于故事文本分析人物特征,生成详细的人物小传。适用于深度理解故事人物设定、为演员塑造角色提供参考、为剧本创作建立人物档案

    446 GitHub stars~609 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Character Relationships

What does Character Relationships do?

Analyze story character relationships, identify types, characteristics, and development changes. Character Relationships is an agent skill from VanGong1999/screen-creative-skills. Analyze story character relationships, identify types, characteristics, and development changes.

How do I install Character Relationships in Claude Code?

Run `npx skills add VanGong1999/screen-creative-skills --skill character-relationships -a claude-code`. Or copy the skill folder (english-version/category/character-analysis/character-relationships in VanGong1999/screen-creative-skills) into .claude/skills/character-relationships in your project. Claude Code loads it when a task matches its description.

How do I install Character Relationships in Codex?

Run `npx skills add VanGong1999/screen-creative-skills --skill character-relationships -a codex`. Or copy the skill folder (english-version/category/character-analysis/character-relationships in VanGong1999/screen-creative-skills) into .agents/skills/character-relationships in your project. Codex loads it when a task matches its description.

Can I use Character Relationships 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 VanGong1999/screen-creative-skills --skill character-relationships -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/character-relationships, .gemini/skills/character-relationships, .github/skills/character-relationships and .opencode/skills/character-relationships in your project.

What does Character Relationships need to run?

SKILL.md names no scripts, command-line tools or credentials: Character Relationships is instructions for the agent only. Its frontmatter pre-approves these tools: Read. Compatibility (from SKILL.md): Claude Code 1.0+.

Does Character Relationships 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 Character Relationships 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. Review the folder before installing.

What licence does Character Relationships use?

Character Relationships 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 Character Relationships use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to Character Relationships?

Skills that share tags, products or a category with Character Relationships: Rust Path Types (openinterpreter/openinterpreter, 69k stars), Python Type Safety (wshobson/agents, 40k stars), Pyrefly Type Coverage (pytorch/pytorch, 104k stars) and Game Story World Character (hashgraph-online/awesome-codex-plugins, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Character Relationships?

VanGong1999 (a GitHub user) maintains it in VanGong1999/screen-creative-skills, which has 446 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on May 26, 2026.

Source: VanGong1999/screen-creative-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.