← Back to Skills Marketplace
140
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install novel-character-graph
Description
Professional long-form novel analysis and character relationship mapping + theme song generation. Automatically handles GBK/UTF-8 encoding, multi-GB file chu...
Usage Guidance
This skill appears to implement sensible local tools for splitting novels, extracting Chinese names, and generating an HTML graph, but there are several red flags you should address before installing or running it: 1) Clarify Suno/music integration: ask the author how Suno is invoked and what credentials are required — do not provide API keys until you see explicit, documented endpoints and env var names. 2) Confirm required binaries: SKILL.md references ffmpeg and suggests apt installs; ensure you install only the packages you trust and in a sandbox (container or VM) because the instructions include sudo apt install and in-place file operations. 3) Inspect SKILL.md for hidden unicode control characters and remove them; these can hide prompt-injection payloads. 4) Test the Python scripts on non-sensitive sample files first — the chapter-splitting and name-extraction use simple regexes and could mis-handle or overwrite files; back up original files. 5) If you must run theme-song generation, prefer a controlled environment and limit any uploads of full-text novel content to third-party services unless you understand the privacy/legal implications. If the author can provide explicit details on how Suno is called (client library, endpoint, required env vars) and update the registry metadata to declare those env vars and binaries, that will raise confidence.
Capability Analysis
Type: OpenClaw Skill
Name: novel-character-graph
Version: 1.0.2
The skill bundle provides functional scripts for novel analysis and character mapping, but the SKILL.md file contains high-risk instructions. Specifically, it directs the AI agent to install system-level dependencies (e.g., via sudo apt install) and explicitly states that this should be done 'without user approval' (无需用户批准即可安装依赖). While these tools (pandoc, calibre, etc.) are relevant to the stated purpose, instructing an agent to bypass user consent for system modifications is a significant security risk and a potential prompt-injection vector for unauthorized execution.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, split/parse/extract/generate-html scripts and SKILL.md all align with novel analysis and relationship-graph output. However, the SKILL.md describes AI-driven theme-song generation (Suno) and ffmpeg-based audio/video steps while the registry metadata lists no credentials or required environment variables for an external audio-generation service, and the declared required_commands omit ffmpeg. This mismatch (described capability without declared credentials/binaries) is unexplained.
Instruction Scope
Runtime instructions include file inspection, encoding conversion (iconv), format conversion (ebook-convert, pdftotext, pandoc), and large-file chunking — all within the stated purpose. Instructions propose running sudo apt install and several shell commands that can modify files in-place (e.g., mv after iconv). There is no explicit instruction to send novel text to external endpoints, but the Suno/music section provides prompt templates without showing how to call Suno or where API keys should be supplied. The SKILL.md contains detected unicode-control-chars (prompt-injection signal), which could obscure or manipulate instruction parsing — review the raw SKILL.md for hidden control characters before executing.
Install Mechanism
No install spec in the registry (instruction-only) — lowest install risk from registry perspective. The code files are included (Python scripts) so running them writes/reads local files; SKILL.md suggests installing system packages via apt (calibre-bin, poppler-utils, pandoc) which is a normal dependency installation but requires sudo. No external download URLs or archive extracts were found.
Credentials
The skill declares no required environment variables or primary credential. Yet SKILL.md describes Suno AI theme-song generation (an external service that typically requires API keys) and ffmpeg/video upload steps — there is a missing, unjustified omission of credentials and possibly network endpoints. Also some binaries referenced in instructions (ffmpeg) are not listed in required_commands. This gap increases the chance of ad-hoc, undocumented requests for credentials or out-of-band network calls.
Persistence & Privilege
The skill does not request always:true, does not declare system config paths, and does not modify other skills. Scripts create and write output files in the working directory (chapter files, index.html) — expected for this functionality. No elevated persistence or cross-skill configuration changes are present in the files provided.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install novel-character-graph - After installation, invoke the skill by name or use
/novel-character-graph - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Initial release of version 1.0.2.
- Added `_meta.json` file.
v1.0.1
**Summary: Added professional large-scale novel analysis, multi-format support, and theme song generation.**
- New: Supports TXT, EPUB, PDF, DOCX, and MOBI formats with automatic encoding detection and conversion.
- New: Splits and processes large files/chaptered novels incrementally, suitable for multi-million word works.
- New: Outputs standardized character system, worldviews, item/skill listings, multi-category relationship graphs, and full markdown reports.
- New: Generates interactive HTML relationship maps with multi-tab structure (relationships, character cards, worldview, manga setup).
- New: Integrated Suno AI-powered theme/OST/song generation for novels, with customizable style templates and lyrics structure.
- Added: Utility scripts for chapter splitting, character extraction, and HTML graph generation.
- Improved: More robust, modular, and professional workflow designed for long-form, complex novel projects.
v1.0.0
Initial version
Metadata
Frequently Asked Questions
What is Novel Character Graph?
Professional long-form novel analysis and character relationship mapping + theme song generation. Automatically handles GBK/UTF-8 encoding, multi-GB file chu... It is an AI Agent Skill for Claude Code / OpenClaw, with 140 downloads so far.
How do I install Novel Character Graph?
Run "/install novel-character-graph" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Novel Character Graph free?
Yes, Novel Character Graph is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Novel Character Graph support?
Novel Character Graph is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Novel Character Graph?
It is built and maintained by mengbin92 (@mengbin92); the current version is v1.0.2.
More Skills