Agent skill

Novel Evaluator

by VanGong1999 in 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.

MITAuto-check passedWriting & Content

Install Novel Evaluator

skills CLI
$ npx skills add VanGong1999/screen-creative-skills --skill novel-evaluator -a claude-code

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

GitHub CLI
$ gh skill install VanGong1999/screen-creative-skills novel-evaluator --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/novel-screening/novel-evaluator .claude/skills/novel-evaluator && 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
novel-evaluator
GitHub stars
446
Token cost
~1.2k tokens
SKILL.md length
389 words
Files
3 (incl. references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 3 steps: Market Potential (scored 1.0–10.0) → Innovation Attributes (scored 1.0–10.0) → Content Highlights (scored 1.0–10.0)
  • Conducting novel initial screening
  • SKILL.md covers Evaluation Dimensions, Scoring Standards, Workflow and Input Requirements, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Novel Evaluator is an agent skill from 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. Use when conducting novel initial screening, assessing IP adaptation potential, scoring stories for multi-dimensional quality comparison, or guiding story creation and optimization direction.

Its SKILL.md is about 1.2k 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+

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

When your agent uses it

  • Conducting novel initial screening
  • Assessing IP adaptation potential
  • Scoring stories for multi-dimensional quality comparison
  • Guiding story creation and optimization direction

Example prompts

  • “/novel-evaluator”

Requirements

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

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Market Potential (scored 1.0–10.0)
  2. Innovation Attributes (scored 1.0–10.0)
  3. Content Highlights (scored 1.0–10.0)

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

Novel Evaluator loads about 1.2k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 98 tokens; SKILL.md has 389 words of instructions outside code blocks.

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

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). 389 words, ~1,193 tokens.

Download SKILL.mdSave it as .claude/skills/novel-evaluator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
novel-evaluator
description
Evaluate and score story text across market potential, innovation attributes, and content highlights dimensions, producing structured scoring reports with development recommendations. Use when conducting novel initial screening, assessing IP adaptation potential, scoring stories for multi-dimensional quality comparison, or guiding story creation and optimization direction.
allowed-tools
Read
compatibility
Claude Code 1.0+
license
MIT
metadata.category
novel-screening
metadata.version
2.1.0
metadata.last_updated
2026-01-11
metadata.maintainer
Gong Fan
metadata.model
opus

Senior Story Evaluation Expert (Novel Edition)

Evaluation Dimensions

1. Market Potential (scored 1.0–10.0)
Sub-dimensionCriteria
Audience FitDoes the story match a defined target demographic? How large is that audience?
Discussion HeatDoes the content contain shareable moments, controversy, or social commentary that drives organic buzz?
ScarcityIs the premise sufficiently unique within the genre, or does it feel derivative?
Performance DataBased on comparable works, what are the market prospects?
2. Innovation Attributes (scored 1.0–10.0)
Sub-dimensionCriteria
Core SelectionIs the central topic or setting fresh and underexplored?
Story ConceptIs the high-concept hook distinctive and easy to pitch in one sentence?
Story DesignDoes the combination of theme, characters, worldview, and plot show originality?
3. Content Highlights (scored 1.0–10.0)
Sub-dimensionCriteria
Theme ConceptIs the thematic intent clear and consistently expressed?
Story SituationDoes the core situation generate sustained tension and dramatic stakes?
Character DesignAre characters multi-dimensional with clear motivations and distinct voices?
Character RelationshipsDo relationships create meaningful conflict and emotional resonance?
Plot SegmentsDo individual plot beats deliver hooks, reversals, and satisfying payoffs?

Scoring Standards

  • 8.5 and above: Excellent, possessing extremely strong competitiveness and adaptation foundation
  • 8.0-8.4: Good, possessing strong competitiveness and adaptation foundation
  • 7.5-7.9: Qualified, average competitiveness
  • 7.4 and below: Poor, almost no competitiveness
Show full SKILL.md (179 more words)Show less

Workflow

  1. Read the full story text; note genre, length, and any stated creative intent.
  2. Score each sub-dimension (1.0–10.0) with a one-sentence justification citing specific text evidence.
  3. Validate consistency — check that sub-dimension scores align with each other (e.g., strong character design should correlate with strong character relationships).
  4. Compute overall score — weighted average across all three dimensions; flag any outlier sub-dimensions.
  5. Produce recommendations — specific, actionable development guidance: proceed / revise with targeted improvement areas.

Input Requirements

  • Complete story text or story outline
  • Story's genre and type (e.g., urban romance, historical fantasy, etc.)

Output Format

[Market Potential]:
- Audience Fit: [Analysis and evaluation] Score: [score]
- Discussion Heat: [Analysis and evaluation] Score: [score]
- Scarcity: [Analysis and evaluation] Score: [score]
- Performance Data: [Analysis and evaluation] Score: [score]

[Innovation Attributes]:
- Core Selection: [Comprehensive analysis] Score: [score]
- Story Concept: [Comprehensive analysis] Score: [score]
- Story Design: [Comprehensive analysis] Score: [score]

[Content Highlights]:
- Theme Concept: [Analysis] Score: [score]
- Story Situation: [Analysis] Score: [score]
- Character Design: [Analysis] Score: [score]
- Character Relationships: [Analysis] Score: [score]
- Plot Segments: [Analysis] Score: [score]

[Overall Evaluation]: [Analysis and evaluation] Total Score: [score]
[Follow-up Recommendations]: [Development recommendations]

Constraints

  • Evaluation must be based on provided story text content; do not independently create or add information
  • Scoring should be objective and fair, accompanied by detailed analysis
  • Recommendations should be specific and feasible, helpful for story improvement

Examples

See {baseDir}/references/examples.md for detailed evaluation examples. This file contains complete evaluation reports and analysis explanations for various story types (urban counterattack, sweet romance, suspense mystery, etc.).

Detailed Documentation

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

  • guide.md - Complete evaluation guide and framework explanation
  • examples.md - More scenario examples

© 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/novel-screening/novel-evaluator of VanGong1999/screen-creative-skills.

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

Open the folder on GitHubat commit 6ced54f

Compare with similar skills

Novel Evaluator 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.

Novel Evaluator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Evaluator this skillVanGong1999/screen-creative-skills446—~1.2kAutomated safety check: PassMIT
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k2 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.3k—~1.1kAutomated safety check: NotesApache-2.0
SepiaNanako0129/sepia3.1k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Story Multi-Perspective Review

    zenstory-ai/oh-story-claudecode

    Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.

    7.4k GitHub starsUsed in 3 repos~3k tokens
    Writing & ContentAuto-check passed
  • Short Web Fiction Trend Scan

    zenstory-ai/oh-story-claudecode

    Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.

    7.4k GitHub starsUsed in 2 repos~1.2k tokens
    Writing & ContentAuto-check passed
  • Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Novel Art

    eternityspring/shuohao-skills

    给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。

    4.3k GitHub stars~1.1k tokensUpdated 2 days ago
    Writing & ContentAuto-check: notes
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3.1k GitHub stars~3.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Story Toolbox Router

    zenstory-ai/oh-story-claudecode

    Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.

    7.4k GitHub stars~1.7k tokensUpdated today
    Writing & ContentAuto-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
  • 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
  • Drama Workflow

    VanGong1999/screen-creative-skills

    协调情节点戏剧功能分析流程,管理文本预处理、并行分析、结果整合。适用于长文本的情节点和戏剧功能分析、需要结构化分析报告的场景

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

Questions about Novel Evaluator

What does Novel Evaluator do?

Evaluate and score story text across market potential, innovation attributes, and content highlights dimensions, producing structured scoring reports with development recommendations. Novel Evaluator is an agent skill from 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.

When should I use Novel Evaluator?

Novel Evaluator fits situations like: conducting novel initial screening; assessing IP adaptation potential; scoring stories for multi-dimensional quality comparison; guiding story creation and optimization direction.

How do I install Novel Evaluator in Claude Code?

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

How do I install Novel Evaluator in Codex?

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

Can I use Novel Evaluator 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 novel-evaluator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/novel-evaluator, .gemini/skills/novel-evaluator, .github/skills/novel-evaluator and .opencode/skills/novel-evaluator in your project.

What does Novel Evaluator need to run?

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

Does Novel Evaluator 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 Novel Evaluator 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 Novel Evaluator use?

Novel Evaluator 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 Novel Evaluator use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Novel Evaluator?

Skills that share tags, products or a category with Novel Evaluator: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novel Evaluator?

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.