Agent skill

Webnovel Dashboard

by lujih in lujih/webnovel-writer-opencode

“启动小说管理面板,查看项目状态、编辑文风约束。”

— description from SKILL.md by lujih
GPL-3.0Auto-check passedWriting & Content

Install Webnovel Dashboard

skills CLI
$ npx skills add lujih/webnovel-writer-opencode --skill webnovel-dashboard -a claude-code

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

GitHub CLI
$ gh skill install lujih/webnovel-writer-opencode webnovel-dashboard --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/lujih/webnovel-writer-opencode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/webnovel-dashboard .claude/skills/webnovel-dashboard && 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
webnovel-dashboard
GitHub stars
214
Token cost
~838 tokens
SKILL.md length
160 words
Files
2 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
GPL-3.0

At a glance

  • Works in 4 steps: :安装依赖 → :解析项目路径 + 校验前端 → :启动 Dashboard(后台运行) → …
  • SKILL.md covers 目标, 功能概览, 文风约束编辑器(/style) and API 参考, plus 5 more sections
  • Calls python, curl and pip

About this skill

Webnovel Dashboard is a skill in lujih/webnovel-writer-opencode (214 stars). Its SKILL.md is about 838 tokens, with 1 other file in the folder (references). Licence: GPL-3.0.

Requirements

  • Compatibility (from SKILL.md): opencode

Workflow steps

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

  1. :安装依赖
  2. :解析项目路径 + 校验前端
  3. :启动 Dashboard(后台运行)
  4. :验证服务

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • curl
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl and pip, which can reach the network depending on how they are called.

    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

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Webnovel Dashboard loads about 838 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 11 tokens; SKILL.md has 160 words of instructions outside code blocks.

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

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 lujih/webnovel-writer-opencode at commit 853bf48, republished under its GPL-3.0 licence (© lujih). 160 words, ~838 tokens.

Download SKILL.mdSave it as .claude/skills/webnovel-dashboard/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
webnovel-dashboard
description
启动小说管理面板,查看项目状态、编辑文风约束。
compatibility
opencode

Webnovel Dashboard

目标

在本地启动 Web 面板,查看创作进度、设定词典、关系图谱、章节内容与追读力数据,并可编辑文风约束。

功能概览

页面路由功能
总览/统计卡片、章节趋势、告警、伏笔提醒
上下文健康/contextToken 预算、Section 状态、权重分布、历史趋势
角色图鉴/characters实体列表、关系图谱、时间线(状态变化+出场记录+异常检测)
审查分析/review维度雷达图、严重程度分布、趋势折线图、Critical Issues
节奏雷达/pacing钩子强度、strand 分布、字数箱线图
伏笔追踪/foreshadowing伏笔甘特图、债务表
文档浏览/files文件树、正文预览
文风约束/style编辑文风约束(6 Tab:自定义文风+全局+禁止+技法+合同+审查维度)
系统状态/system合同树、提交历史、RAG 环境、运维操作、批量操作
主题

支持亮色/暗色模式切换(侧边栏右上角 🌙/☀️ 按钮),偏好持久化到 localStorage。

文风约束编辑器(/style)

6 个 Tab:自定义文风(设定集/prompts/*.md,读写)、全局文风(MASTER_SETTING.json,读写)、禁止模式(anti_patterns.json,读写)、写作技法(CSV,只读)、章级合同(只读)、审查维度(只读)。

API 参考

写入 API(8 个)、只读 API(6 个)、配置说明见 references/dashboard-api.md。

环境设置

bash
# 以下命令假设当前目录为 webnovel-writer 仓库根目录
export SCRIPTS_DIR="${PWD}/.opencode/scripts"
export DASHBOARD_DIR="${PWD}/.opencode/dashboard"
test -d "${DASHBOARD_DIR}" || { echo "错误: 未找到 ${DASHBOARD_DIR},请确保当前目录是 webnovel-writer 仓库根目录"; exit 1; }

执行流程

Step 1:安装依赖
bash
python -m pip install -r "${DASHBOARD_DIR}/requirements.txt" --quiet
Step 2:解析项目路径 + 校验前端
bash
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PWD}" where)"
test -n "$PROJECT_ROOT" && test -f "${PROJECT_ROOT}/.webnovel/state.json" || { echo "错误: PROJECT_ROOT 解析失败,请用 --project-root 显式指定"; exit 1; }
echo "项目路径: ${PROJECT_ROOT}"

test -f "${DASHBOARD_DIR}/frontend/dist/index.html" || { echo "错误: 缺少前端构建产物 ${DASHBOARD_DIR}/frontend/dist/index.html"; exit 1; }
Step 3:启动 Dashboard(后台运行)

Dashboard 是长运行服务(uvicorn),必须用后台模式启动。命令中设置 run_in_background: true。

bash
PYTHONPATH="${PWD}/.opencode" python -X utf8 -m dashboard.server --project-root "${PROJECT_ROOT}"

默认端口 8765,访问 http://127.0.0.1:8765。

自定义端口:

bash
PYTHONPATH="${PWD}/.opencode" python -X utf8 -m dashboard.server --project-root "${PROJECT_ROOT}" --port 9000 --no-browser

自动关闭旧进程并启动:

bash
PYTHONPATH="${PWD}/.opencode" python -X utf8 -m dashboard.server --project-root "${PROJECT_ROOT}" --kill-existing --no-browser
Step 4:验证服务
bash
curl -s http://127.0.0.1:8765/api/story-runtime/health || echo "服务未启动"
curl -s http://127.0.0.1:8765/api/style/master-setting || echo "文风编辑器不可用"

项目根目录解析

server.py 按以下优先级解析项目根目录:

  1. --project-root 参数
  2. WEBNOVEL_PROJECT_ROOT 环境变量
  3. CWD 向上搜索(找到包含 .webnovel/state.json 的目录)
  4. .opencode/.webnovel-current-project 指针文件
  5. 智能搜索同级目录(支持嵌套结构如 E:\workspace\webnovel\书名\)

注意事项

  • Dashboard 提供只读查询 + 文风约束编辑(写入操作限于 master_constraints 和 anti_patterns)
  • uvicorn 默认监听 127.0.0.1:8765
  • 首次启动可能需安装依赖(pip install -r requirements.txt)
  • Windows 中文输出乱码:运行 chcp 65001 后重试
  • 端口被占用时自动检测并提示,可用 --kill-existing 自动关闭旧进程

失败恢复

故障恢复方式
依赖安装失败检查 Python 版本,手动 pip install -r requirements.txt
前端 dist/ 缺失确认插件完整安装
PROJECT_ROOT 解析失败显式传 --project-root 或设置 WEBNOVEL_PROJECT_ROOT 环境变量
端口占用使用 --kill-existing 自动关闭旧进程,或 --port <其他端口>
服务被 timeout 终止确保使用后台模式(run_in_background: true)启动
页面空白/数据缺失确认 .webnovel/ 下有 state.json、index.db 等数据文件

© lujih, GPL-3.0. 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 1 other file (references) in .opencode/skills/webnovel-dashboard of lujih/webnovel-writer-opencode.

  • SKILL.md
  • references/dashboard-api.md

Open the folder on GitHubat commit 853bf48

Compare with similar skills

Webnovel Dashboard 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.

Webnovel Dashboard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Webnovel Dashboard this skilllujih/webnovel-writer-opencode214—~838Automated safety check: PassGPL-3.0
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
HumanizerAzure-Samples/interview-coach-agent-framework17338 repos~5.8kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
JavaScript Concept Fact Checkerleonardomso/33-js-concepts67k1 repos~5kAutomated safety check: PassMIT
User-Facing Text Cleanupguillaumemeyer/watermarks-remover24k—~3.5kAutomated safety check: PassMIT

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Humanizer

    Azure-Samples/interview-coach-agent-framework

    Official

    Remove signs of AI-generated writing from text. An agent skill from Azure-Samples/interview-coach-agent-framework.

    173 GitHub starsUsed in 38 repos~5.8k tokens
    Writing & ContentAuto-check passed
  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • JavaScript Concept Fact Checker

    leonardomso/33-js-concepts

    Verifies the technical accuracy of JavaScript concept pages by checking code examples, MDN and ECMAScript claims and external links through a five-phase method.

    67k GitHub starsUsed in 1 repo~5k tokens
    Writing & ContentAuto-check passed
  • User-Facing Text Cleanup

    guillaumemeyer/watermarks-remover

    Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.

    24k GitHub stars~3.5k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Install Anti Slop

    trycompai/crm

    Install and configure the anti-slop Oxlint plugin in a local TypeScript or JavaScript repository.

    11k GitHub starsUsed in 1 repo~881 tokens
    Writing & ContentAuto-check passed

More from lujih/webnovel-writer-opencode

All 15 skills in this repo
  • Webnovel Init

    lujih/webnovel-writer-opencode

    深度初始化网文项目。通过分阶段交互收集完整创作信息,生成可直接进入规划与写作的项目骨架与约束文件. An agent skill from lujih/webnovel-writer-opencode.

    215 GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Webnovel Query

    lujih/webnovel-writer-opencode

    查询项目设定、角色、力量体系、势力、伏笔等信息。支持紧急度分析与金手指状态查询. An agent skill from lujih/webnovel-writer-opencode.

    215 GitHub stars~846 tokensUpdated today
    Auto-check passed
  • Webnovel Write Batch

    lujih/webnovel-writer-opencode

    连续写作多章。当用户要求多章写作时必须使用此 skill. An agent skill from lujih/webnovel-writer-opencode.

    215 GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Webnovel Export

    lujih/webnovel-writer-opencode

    将网文正文导出为 Markdown/TXT/EPUB/HTML/DOCX/PDF 格式。立即使用此 skill 当用户说:导出、导出小说、导出章节、生成电子书、导出 TXT、导出 Markdown、导出 EPUB、导出 HTML、导出 Word、导出 PDF、下载小说、输出正文。

    215 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Webnovel Heal

    lujih/webnovel-writer-opencode

    修复问题章节——诊断、清理脏实体、重审查、重提交。触发:章节断裂、OOC偏离、设定矛盾修复. An agent skill from lujih/webnovel-writer-opencode.

    215 GitHub stars~524 tokensUpdated today
    Auto-check passed
  • Webnovel Publish

    lujih/webnovel-writer-opencode

    将小说章节自动发布到国内主流小说平台(番茄等)。触发条件:"发布小说"、"发布章节"、"上传到番茄"、"自动发布"、"清理草稿"、"发布草稿"。

    215 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Questions about Webnovel Dashboard

How do I install Webnovel Dashboard in Claude Code?

Run `npx skills add lujih/webnovel-writer-opencode --skill webnovel-dashboard -a claude-code`. Or copy the skill folder (.opencode/skills/webnovel-dashboard in lujih/webnovel-writer-opencode) into .claude/skills/webnovel-dashboard in your project. Claude Code loads it when a task matches its description.

How do I install Webnovel Dashboard in Codex?

Run `npx skills add lujih/webnovel-writer-opencode --skill webnovel-dashboard -a codex`. Or copy the skill folder (.opencode/skills/webnovel-dashboard in lujih/webnovel-writer-opencode) into .agents/skills/webnovel-dashboard in your project. Codex loads it when a task matches its description.

Can I use Webnovel Dashboard 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 lujih/webnovel-writer-opencode --skill webnovel-dashboard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/webnovel-dashboard, .gemini/skills/webnovel-dashboard, .github/skills/webnovel-dashboard and .opencode/skills/webnovel-dashboard in your project.

What does Webnovel Dashboard need to run?

Going by SKILL.md and its folder, Webnovel Dashboard needs the command-line tools its instructions call (python, curl and pip). Compatibility (from SKILL.md): opencode.

Does Webnovel Dashboard access the network?

SKILL.md contains no URLs. Its commands use curl and pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Webnovel Dashboard 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 Webnovel Dashboard use?

Webnovel Dashboard is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Webnovel Dashboard use?

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

What are the alternatives to Webnovel Dashboard?

Skills that share tags, products or a category with Webnovel Dashboard: Social (coreyhaines31/marketingskills, 54k stars), Humanizer (Azure-Samples/interview-coach-agent-framework, 173 stars), Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars) and JavaScript Concept Fact Checker (leonardomso/33-js-concepts, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Webnovel Dashboard?

lujih (a GitHub user) maintains it in lujih/webnovel-writer-opencode, which has 214 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 2026.

Source: lujih/webnovel-writer-opencode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.