← Back to Skills Marketplace
166
Downloads
1
Stars
0
Active Installs
10
Versions
Install in OpenClaw
/install onkos
Description
MANDATORY novel engine; LLM CANNOT maintain cross-chapter consistency or track facts/hooks. Activate when user says 写小说/构思故事/续写/改章节/检查连贯性 or similar.
Usage Guidance
Onkos appears to be a full-featured long-form fiction engine and most of its files and instructions align with that purpose. The main risks to weigh before installing: (1) It will create and modify local project files and an SQLite database — expect persistent storage in your filesystem. (2) At runtime it likely downloads a quantized ONNX embedding model; the declared download sources include a personal Tencent COS bucket and a third‑party mirror in addition to HuggingFace. If you plan to use this skill: - Inspect the Python scripts (especially command_executor.py, settings_importer.py, and any networking code) before running. - Prefer to run it in a sandboxed environment (container or VM) or with a throwaway project directory. - If it downloads the .onnx model, verify the file sha256 matches the provided hash and prefer official sources (HuggingFace) over unknown mirrors. - Be cautious when using 'import-settings' with paths — it will read user files you point it to. - If you cannot inspect the code, do not grant it persistent access to sensitive directories or credentials, and avoid running on a machine with sensitive data. Additional information that would raise confidence: a full review of the actual script contents (to confirm no hidden network exfiltration or remote command execution), confirmation that the model download only uses official HF URLs, and verification that the referenced sha256 is enforced by the downloader.
Capability Tags
Capability Assessment
Purpose & Capability
The skill name/description (novel engine / long-form consistency) aligns with the provided scripts and reference docs: memory, fact engine, entity extraction, continuity checks, hook tracking, etc. The many script files and reference docs are coherent with a local book-scale consistency system; requiring a local ONNX embedding model and sqlite DB is sensible for the described functionality.
Instruction Scope
SKILL.md prescribes a strict pipeline (for-creation → write → store → extract → detect → record → update summary) and forces use of command_executor.py for all script calls. This is consistent with an integrated toolchain but gives the skill broad discretion to read/write project files, import arbitrary user-provided settings (paths) and run many scripts. Those file I/O and DB operations are expected for the purpose but widen the runtime surface (reads of user-specified files, automatic DB reads of chapters, automatic imports) and should be reviewed.
Install Mechanism
There is no install spec, but assets/settings.json declares download sources for an ONNX model and a sha256. The listed sources include HuggingFace (expected) and two third-party mirrors: 'hf-mirror.com' and a Tencent COS URL (tools-1307431188.cos.ap-chongqing.myqcloud.com). Downloading and extracting an INT8 ONNX binary from a personal cloud bucket is higher risk (possible supply‑chain tampering). The package does not include the .onnx model itself in assets, so runtime network download is likely. This is the primary technical concern.
Credentials
The skill does not request environment variables, secrets, or external credentials in registry metadata. Its runtime behavior (writing a local SQLite DB, reading project files, optionally downloading a model) is proportionate to a large local fiction tool. However, because it may fetch an external model from third-party hosts, network access (and verifying downloaded artifacts' integrity) is relevant even though no credentials are requested.
Persistence & Privilege
The skill writes persistent project artifacts (data/novel_memory.db, character profiles, outlines) and installs/uses a local ONNX model. It does not declare 'always: true'. Persistent local storage is reasonable for the purpose but increases blast radius: the skill can accumulate many facts and hooks and will auto-read stored chapters during checks. Review whether you want those files created in your environment.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install onkos - After installation, invoke the skill by name or use
/onkos - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.6.3
版本号对齐;移除降级硬编码;COS地址更新;示例模板脱敏
v1.6.1
移除semantic_model.py降级硬编码,缺失/损坏时提示解决方案和格式示例;COS地址更新为tools-1307431188;示例模板不暴露私有CDN地址
v1.5.1
SKILL.md重构为触发优先架构:MANDATORY RULES铁律、Anti-Pattern半触发防护、Pre-flight Check、NL→OPERATION映射、FIRST-TIME SETUP引导、删除/help系统节省50行token、description扩展触发词
v1.6.0
SKILL.md重构为触发优先架构:MANDATORY RULES铁律、Anti-Pattern半触发防护、Pre-flight Check、NL→OPERATION映射、FIRST-TIME SETUP引导、删除/help系统节省50行token、description扩展触发词
v1.5.0
v1.5.0: 追读力系统上线; 修复create-character参数别名映射(OOC检测); 修复中文关键词2-gram拆分; 补充PARAM_MAP映射(debt-report/analyze-revision); SHA256校验+subprocess防注入; 事务原子操作+资源泄漏修复; clear-chapter/supersede-chapter-facts/abandon-chapter-hooks新增
v1.4.0
**新增设定文档批量导入与事实变更检测,优化长篇小说创作核心工作流。**
- 新增 Markdown 设定文档批量导入功能(/导入设定、/import-settings),自动解析设定与关系,支持预览更新删除。
- 创作核心流程内新增“检测事实变更”步骤,支持自动识别新事实、冲突与更新(/检测事实变更、/detect-changes),智能体辅助用户高效录入和修正设定。
- 帮助指令与资源索引同步增加设定与变更检测相关内容,丰富参考文档(references/settings_format.md, references/workflows.md)。
- 工作流文档重构,意图与指令细分外部 references,整体结构更清晰。
- 小幅优化实体自动去重、OOC检测、章节修订等辅助功能。
v1.0.3
Version 1.0.3
- 移除了 requirements.txt 文件。
- 依赖和交付说明现在仅在 SKILL.md 中声明。
- 其他功能与描述未作更改。
v1.0.2
No changes detected in files or documentation for version 1.0.2.
- Version remains functionally identical to 1.0.1.
- No new features, fixes, or updates included in this release.
v1.0.1
Version 1.0.1
- 新增 requirements.txt 文件,明确 Skill 的 Python 依赖。
- 无其它功能变更。
v1.0.0
onkos 1.0.0 – 长篇小说AI创作伙伴首次发布
- 支持高达2000章、600万字体量的长篇小说创作与管理
- 提供6级分层摘要、SQLite事实相关性引擎与本地语义检索,保障全局连贯性
- 多角色协作建模,含角色心理、知识图谱构建、伏笔追踪与质量审计
- 完整覆盖小说项目的规划、创作、查询、检查、修改、管理、支线与风格分析等全流程
- 内置快捷指令与自然语言意图识别,无需记忆参数,易用性强
- 首次启动自动完成依赖与语义模型下载,提升开箱体验
Metadata
Frequently Asked Questions
What is Onkos?
MANDATORY novel engine; LLM CANNOT maintain cross-chapter consistency or track facts/hooks. Activate when user says 写小说/构思故事/续写/改章节/检查连贯性 or similar. It is an AI Agent Skill for Claude Code / OpenClaw, with 166 downloads so far.
How do I install Onkos?
Run "/install onkos" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Onkos free?
Yes, Onkos is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Onkos support?
Onkos is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Onkos?
It is built and maintained by smallroya (@smallroya); the current version is v1.6.3.
More Skills