Home / modoojunko / awesome-novel-agent · GitHub

awesome-novel SKILL.md skillA

awesome-novel from modoojunko/awesome-novel-agent is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add modoojunko/awesome-novel-agent/awesome-novel@git:20260910.38399bc

Pins git:20260910.38399bc in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: modoojunko/awesome-novel-agent
Path: SKILL.md
Versions recorded: 5
Latest version: git:20260910.38399bc, committed Sep 10, 2026
First version recorded: Aug 16, 2026
Size: 26,316 bytes
Repository stars: 857
License: AGPL-3.0

和 AI 协作写小说的工作流系统。9 个 agent 协作完成从设定到归档的完整写作流程。入口检测 → 初始化/迁移 → 交 novel-agent 调度。适用场景：从零写新小说、导入已有小说。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Novel — 小说创作工作流

和 AI 一起写小说。本 skill 负责项目状态检测、新项目初始化、旧版项目自动迁移，完成后将控制权交给 novel-agent。

**唤起方式：** 用户在项目目录输入 `/awesome-novel`（Claude Code / OpenCode / Grok Build 直接输入；Codex 输入 `/use awesome-novel`；或说"帮我写本小说"）即进入下方检测流程。新目录会先询问作者，确认后运行 `init.py` 在本地初始化小说工作空间。

## OpenCode 集成说明

本 skill 也支持 OpenCode。安装在 `~/.config/opencode/skills/awesome-novel/` 后，项目初始化脚本会自动部署 agent 定义到 `.opencode/agents/`，OpenCode 即可自动发现：
- `@novel-agent` — 加载总指挥 agent
- `@volume-planner`、`@chapter-planner` 等 — 加载子 agent
- **Task 工具** — novel-agent 通过 Task 工具调用子 agent

**调度机制：** novel-agent 写 order 文件到 `.agent/task/`（`status: pending`）→ Task 工具调用子 agent → 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。

## Codex 集成说明

本 skill 也支持 Codex。skill 本体**用户级安装**到 `~/.codex/skills/awesome-novel/`；`init.py --platform codex` 初始化小说项目时，把 9 个自定义 agent 部署为项目级 `.codex/agents/*.toml`（Codex 官方 TOML 格式，含 `name`/`description`/`developer_instructions`）：
- `@novel-agent` — 总指挥 agent（TOML 名 `novel-agent`）
- `@volume-planner`、`@chapter-planner` 等 — 子 agent（TOML 名与源 agent 一致）
- **独立工具** — `memory-recording`、`roleplay-sandbox` 部署为 `.codex/skills/<name>/SKILL.md`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add modoojunko/awesome-novel-agent/awesome-novel@sha256:ee3f0fa1da04b841

The line at the top of this page pins the label git:20260910.38399bc, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_hjvxahsfhr24fgta.svg)](https://markdownregistry.com/a/art_hjvxahsfhr24fgta)

7 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 16, 2026 and Sep 10, 2026, about one every 6 days.

version	committed	commit	size	audit
git:20260910.38399bc latest	2026-09-10	38399bc	26,316 B	A	view · diff
git:20260910.a9cf3c6	2026-09-10	a9cf3c6	25,934 B	A	view · diff
git:20260828.0827fb7	2026-08-28	0827fb7	24,397 B	A	view · diff
git:20260823.3bdca9f	2026-08-23	3bdca9f	23,971 B	A	view · diff
git:20260816.41c63e3	2026-08-16	41c63e3	22,270 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (26316 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

modoojunko/awesome-novel-agent · 857 stars · license AGPL-3.0 · pushed 2026-09-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hjvxahsfhr24fgta
GET https://markdownregistry.com/api/v1/resolve?ref=modoojunko/awesome-novel-agent/awesome-novel
GET https://markdownregistry.com/api/v1/blob/ee3f0fa1da04b8414a273fccdaddaac0b906483790d47f66cf01eb63b4711dbb

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.