Agent skill

Webnovel Query

by lujih in lujih/webnovel-writer-opencode

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

GPL-3.0Auto-check passedWriting & Content

Install Webnovel Query

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

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

GitHub CLI
$ gh skill install lujih/webnovel-writer-opencode webnovel-query --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-query .claude/skills/webnovel-query && 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-query
GitHub stars
214
Token cost
~846 tokens
SKILL.md length
141 words
Files
4 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
GPL-3.0

At a glance

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

  • Works in 7 steps: 识别查询类型:根据用户关键词匹配上表 → 加载参考:只加载该类型需要的 reference → 加载主链上下文 → …
  • Writing & Content work in your project
  • SKILL.md covers Use when, 项目根保护, 查询类型识别 and 引用加载策略, plus 3 more sections
  • Calls python

What it does

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

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/advanced/foreshadowing.md`, `references/system-data-flow.md` and `references/tag-specification.md`). Compatibility notes: opencode

It sits in Writing & Content. The repository describes itself as: 本项目是基于webnovel-writer 改编的 OpenCode 版本,目标是让用户在OpenCode 使用长篇网文创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题,支持 200 万字量级 连载创作。 The licence is GPL-3.0.

When your agent uses it

  • Writing & Content work in your project

Example prompts

  • “/webnovel-query”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): opencode

Workflow steps

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

  1. 识别查询类型:根据用户关键词匹配上表
  2. 加载参考:只加载该类型需要的 reference
  3. 加载主链上下文
  4. 按优先级查询数据源(写前真源 → 写后真源 → 投影层)
  5. 确认上下文充足:查询类型已识别 + 主链合同 / latest commit 已加载
  6. 执行查询:按类型检索对应数据源。若为时序查询,使用以下命令
  7. 格式化输出:按下方模板输出

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

    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

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Webnovel Query loads about 846 tokens when it runs, and up to ~5.9k if it reads all its reference files. Until then it costs about 14 tokens; SKILL.md has 141 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~14
When it runs · the whole SKILL.md, loaded when a task matches
~846
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.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 lujih/webnovel-writer-opencode at commit 853bf48, republished under its GPL-3.0 licence (© lujih). 141 words, ~846 tokens.

Download SKILL.mdSave it as .claude/skills/webnovel-query/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
webnovel-query
description
查询项目设定、角色、力量体系、势力、伏笔等信息。支持紧急度分析与金手指状态查询。
compatibility
opencode

Information Query Skill

Use when

用户询问关于故事设定、角色、力量体系、势力、伏笔、金手指、节奏等项目内信息时触发。

项目根保护

bash
export WORKSPACE_ROOT="${PWD}"
export SCRIPTS_DIR="${PWD}/.opencode/scripts"
export SKILL_ROOT="${PWD}/.opencode/skills/webnovel-query"
export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
test -n "$PROJECT_ROOT" && test -f "${PROJECT_ROOT}/.webnovel/state.json" || { echo "❌ PROJECT_ROOT 解析失败"; exit 1; }
  • PROJECT_ROOT 必须包含 .webnovel/state.json
  • 禁止在 .opencode/ 下读取或写入项目文件

查询类型识别

关键词查询类型数据源
角色/主角/配角标准查询主角卡.md, 角色库/
境界/筑基/金丹标准查询力量体系.md
宗门/势力/地点标准查询世界观.md
伏笔/紧急伏笔伏笔分析state.json + foreshadowing.md
金手指/系统金手指状态state.json
节奏/Strand节奏分析state.json + strand-weave-pattern.md
标签/实体格式格式查询tag-specification.md
某角色在第N章时/历史状态/时间点状态时序查询knowledge query-entity-state / query-relationships
规则变更/设定演进/OverrideOverride 查询webnovel override context

引用加载策略

先识别查询类型,再按需加载。路径说明:references/ 指 skill 私有 skills/webnovel-query/references/;../../references/ 指共享 references。

查询类型Reference实际路径
所有查询数据流规范${SKILL_ROOT}/references/system-data-flow.md
伏笔分析伏笔分析${SKILL_ROOT}/references/advanced/foreshadowing.md
节奏分析Strand 模式${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md
格式查询标签规范${SKILL_ROOT}/references/tag-specification.md

不得同时加载两个以上 L2 文件,除非用户请求明确跨多类型。

查询流程

  1. 识别查询类型:根据用户关键词匹配上表
  2. 加载参考:只加载该类型需要的 reference
  3. 加载主链上下文:
bash
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" memory-contract load-context --chapter {chapter_num}
  1. 按优先级查询数据源(写前真源 → 写后真源 → 投影层):

    1. .story-system/MASTER_SETTING.json - 全书主设定(题材、调性、核心禁忌)
    2. .story-system/volumes/*.json - 卷级合同(本卷目标、节奏策略)
    3. .story-system/chapters/*.json - 章级合同(本章焦点、动态上下文)
    4. latest accepted .story-system/commits/chapter_XXX.commit.json - 写后事实(已发布章节的定稿状态)
    5. memory-contract load-context - 记忆编排结果(长期记忆、伏笔、时间线)
    6. .webnovel/state.json / index.db - 投影层(仅 fallback/read-model,类比网文后台的"角色卡"、"章节列表")

    优先级说明:

    • 写前真源(1-3):作者开写前必须遵守的"大纲、设定、禁区"
    • 写后真源(4):已发布章节的"定稿状态",不可篡改
    • 投影层(5-6):从写后真源自动生成的"查询视图",方便快速检索
  2. 确认上下文充足:查询类型已识别 + 主链合同 / latest commit 已加载

  3. 执行查询:按类型检索对应数据源。若为时序查询,使用以下命令:

bash
# 查询某实体在指定章节时的状态
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" knowledge query-entity-state --entity "{entity_id}" --at-chapter {N}

# 查询某实体在指定章节时的所有关系
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" knowledge query-relationships --entity "{entity_id}" --at-chapter {N}

# 查询当前生效的世界规则变更(Override Contracts)
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" override context --chapter {N}
  1. 格式化输出:按下方模板输出

输出格式

markdown
# 查询结果:{关键词}

## 概要
- **匹配类型**: {type}
- **数据源**: state.json + 设定集 + 大纲
- **匹配数量**: X 条

## 详细信息
{结构化数据,含文件路径和行号}

## 数据一致性检查
{state.json 与静态文件的差异,若无差异则省略}

边界与失败恢复

  • 只读操作,不修改任何项目文件
  • 若数据源缺失,明确告知用户缺少什么文件
  • 若查询无匹配,返回空结果并建议检查范围
  • 若 .story-system/ 合同与 accepted commit 缺失,必须显式说明当前查询已降级到 legacy fallback

© 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 3 other files (references) in .opencode/skills/webnovel-query of lujih/webnovel-writer-opencode.

  • SKILL.md
  • references/advanced/foreshadowing.md
  • references/system-data-flow.md
  • references/tag-specification.md

Open the folder on GitHubat commit 853bf48

Compare with similar skills

Webnovel Query 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 Query compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Webnovel Query this skilllujih/webnovel-writer-opencode214—~846Automated 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 yesterday
    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.

    214 GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Webnovel Write Batch

    lujih/webnovel-writer-opencode

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

    214 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、下载小说、输出正文。

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

    lujih/webnovel-writer-opencode

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

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

    lujih/webnovel-writer-opencode

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

    214 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Webnovel Delete

    lujih/webnovel-writer-opencode

    安全删除指定章节并清理关联投影数据(state/memory)。支持 dry-run 预览。触发:删除章节、回退写作、清理烂章。

    214 GitHub stars~301 tokensUpdated today
    Auto-check passed

Questions about Webnovel Query

What does Webnovel Query do?

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

When should I use Webnovel Query?

Webnovel Query fits situations like: writing & Content work in your project.

How do I install Webnovel Query in Claude Code?

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

How do I install Webnovel Query in Codex?

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

Can I use Webnovel Query 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-query -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-query, .gemini/skills/webnovel-query, .github/skills/webnovel-query and .opencode/skills/webnovel-query in your project.

What does Webnovel Query need to run?

Going by SKILL.md and its folder, Webnovel Query needs the command-line tools its instructions call (python). Our summary lists: Python 3. Compatibility (from SKILL.md): opencode.

Does Webnovel Query 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 Webnovel Query 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 Query use?

Webnovel Query 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 Query use?

About 846 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 5k tokens, read only when the agent opens those files.

What are the alternatives to Webnovel Query?

Skills that share tags, products or a category with Webnovel Query: 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 Query?

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.