REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
让 AI agent成为你的小说创作搭档。从世界观搭建到角色塑造,从章节规划到正文写作,一步步陪你完成整部小说。
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/skills/modoojunko-awesome-novel-agent)Servidores MCP que conectan la IA a servicios para el mismo trabajo
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
MCP server for terminal commands, file operations, and process management
Mismo tipo de trabajo, ordenadas como la lista de Skills
| Este awesome-novel-agent | rea | graphify | archify | security-audit-skill | |
|---|---|---|---|---|---|
| Autor | modoojunko | morluto | Graphify-Labs | tt-a1i | cloudflare |
| Skills | 1 | 1 | 1 | 1 | 1 |
| Estrellas de GitHub | 870 | 461.751 | 148.352 | 96.757 | 73.156 |
| Último cambio de código | 25 sept 2026 | 16 nov 2026 | 16 nov 2026 | 15 nov 2026 | 15 sept 2026 |
| Licencia | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
1 skills (conjuntos de instrucciones) de modoojunko que la IA lee y sigue · no es un MCP server
MCP = las manos
Conecta la IA a un servicio o dato externo, como leer Notion o crear una factura. Necesita un programa o servidor en marcha.
Skill = el manual
Un archivo de texto que enseña a la IA cómo hacer una tarea. No se conecta a nada.
A veces se parecen: algunas Skills ejecutan scripts que llaman herramientas y algunos MCP solo envían conocimiento. Empieza por la tarea que quieres hacer.
Claude CodeCodexOpenCode
Según el README del autor y las carpetas del repo
GitHub account modoojunko (person), 12 years old
★ 870 stars · code last changed 25 sept 2026
21 scripts that can run on a computer: install.sh, install.ps1, tools/check-agents.py, tools/check-chapter.py and 17 more
Could not check every script (some are too large); read them first
Scripts that touch settings folders (~/.claude or settings.json): install.ps1, install.sh
Checked automatically from the repo files at commit dcd1920 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
Primero: ¿qué IA usas?
Elige tu app y esta página mostrará solo cómo instalarlo en ella
This skill uses the AGPL-3.0 license, which is not on the list we redistribute, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier
Download from GitHub (whole repo) ↗
Unzip it, then zip only the awesome-novel-agent folder again. The ZIP must have a awesome-novel folder with SKILL.md at the top level, no loose files
+Create skillUpload a skillpick awesome-novel.zip
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs 12 nov 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Copia esta frase y pégala en un chat de Claude Code
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Vuelve a abrir Claude Code y escribe /awesome-novel-agent, o pide una tarea relacionada y Claude lo usará
Checked against official docs 12 nov 2026 · Source: code.claude.com
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
La app de escritorio de ChatGPT incluye Codex, y Codex lee las skills de la carpeta ~/.agents/skills
Abre Codex en la app de escritorio de ChatGPT y pega esta frase en el chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Coloca la carpeta awesome-novel en ~/.agents/skills/awesome-novel
~ es tu carpeta de inicio ($HOME)
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Las skills que instalas tú no funcionan aquí; solo las que vienen con un plugin del directorio
Para usar esta skill con ChatGPT, usa la app de escritorio de ChatGPT como se indica arriba
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Copia esta frase y pégala en un chat de Codex · Sirve en Codex dentro de la app de escritorio de ChatGPT, en Codex CLI y en la extensión del IDE
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex detecta solo las skills recién instaladas; si una no aparece, reinicia Codex · Para usarla: en ChatGPT escribe @ y elige la skill · en Codex CLI o la extensión del IDE ejecuta /skills o escribe $ y el nombre de la skill
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
Copia esta frase y pégala en un chat de Cursor
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
En el chat Agent de Cursor escribe / y elige awesome-novel-agent
Checked against official docs 12 nov 2026 · Source: cursor.com
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
Para otras apps que leen skills. La frase incluye las rutas de Claude Code, Codex y Cursor para que la IA elija la de tu app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 12 nov 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Otras apps con Agent Skills (como Gemini CLI o GitHub Copilot) usan otras carpetas. Mira la guía de esa app y copia allí la carpeta con el SKILL.md.
Carpetas de skills comprobadas con las guías oficiales de Claude Code, Codex y Cursor el 11 nov 2026
El texto siguiente viene del repo del autor, no de PopNx MCP
Se muestran los primeros 8000 caracteres · Abrir el archivo completo en GitHub
---
name: awesome-novel
description: 和 AI 协作写小说的工作流系统。9 个 agent 协作完成从设定到归档的完整写作流程。入口检测 → 初始化/迁移 → 交 novel-agent 调度。适用场景:从零写新小说、导入已有小说。
---
# 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`
**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `spawn_agent` 调度子 agent(agent 名 = `.codex/agents/*.toml` 的 name)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。
## ZCode 集成说明
本 skill 也支持 ZCode。ZCode 的 skill 约定(目录 + `SKILL.md`)与 Claude Code 同源,天然兼容;但 ZCode 无项目级 agents 目录,agents 即 skills。skill 本体**用户级安装**到 `~/.zcode/skills/awesome-novel/`;`init.py --platform zcode` 初始化小说项目时,把 9 个 agent 部署为项目级 `.zcode/skills/<name>/SKILL.md`(与 Reasonix 同构,另含 memory-recording、roleplay-sandbox 独立工具,共 11 个 skill):
- novel-agent — 总指挥(入口调度者,由 ZCode 按描述自动发现,无 `@` 语法)
- writer、volume-planner、chapter-planner 等 — 子 agent(subagent skill,由 novel-agent 用 Agent 工具按 skill 名 spawn)
**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `Agent` 工具调度子 agent(子 agent 名 = `.zcode/skills/` 下的 skill 名)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。
## dsh 集成说明
本 skill 也支持 DeepSeek Harness(dsh,DeepSeek 官方的开源 agent harness)。dsh 的 skill 约定(目录 + `SKILL.md`,frontmatter 只认 `name`/`description`)与 Claude Code 同源,天然兼容;但 dsh 无项目级 agents 目录(subagent 是运行时能力),agents 即 skills。skill 本体**用户级安装**到 `~/.dsh/skills/awesome-novel/`;`init.py --platform dsh` 初始化小说项目时,把 9 个 agent 部署为项目级 `.dsh/skills/<name>/SKILL.md`(与 ZCode 同构,另含 memory-recording、roleplay-sandbox 独立工具,共 11 个 skill;`<项目根>/.dsh/skills/` 是 dsh 的项目级 skill 根,自动发现且优先级最高):
- novel-agent — 总指挥(入口调度者,由 dsh 按 name/description 自动路由,无 `@` 语法)
- writer、volume-planner、chapter-planner 等 — 子 agent(subagent skill,由 novel-agent 用 `subagent` 工具调度)
**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `subagent` 工具调度子 agent(prompt 中要求子 agent 先调用 `skill(name="<子agent名>")` 加载自身指令;子 agent 名 = `.dsh/skills/` 下的 skill 名)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。
## Grok Build 集成说明
本 skill 也支持 [Grok Build](https://docs.x.ai/build/overview)(SpaceXAI 的编码 agent TUI)。skill 本体**用户级安装**到 `~/.grok/skills/awesome-novel/`;`init.py --platform grok` 初始化小说项目时,把 9 个自定义 agent 部署为项目级 `.grok/agents/*.md`(Grok 原生 agent 发现路径,含 `name`/`description`/`tools`):
- novel-agent — 总指挥(必须在主会话运行;Grok 子代理深度上限为 1,禁止把 novel-agent 当 subagent 调度)
- writer、volume-planner、chapter-planner 等 — 子 agent(由 novel-agent 用 `spawn_subagent` 按 `subagent_type` 调度)
- **独立工具** — `memory-recording`、`roleplay-sandbox` 部署为 `.grok/skills/<name>/SKILL.md`
**调度机制:** novel-agent 写 order 文件到 `.agent/task/`(`status: pending`)→ 用 `spawn_subagent` 调度子 agent(`subagent_type` = `.grok/agents/*.md` 的 name,`isolation: none`)→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。
## 检测流程 — 严格按此执行,禁止跳过
```
用户输入 /awesome-novel(或"帮我写本小说")→ 检测项目状态
├─ 作者表达的是短篇意图("写短篇 / 写个盐言故事 / 写个短故事")→ 走短篇分支(见下)
├─ story.yaml 存在 → 旧版 2.x → 执行自动迁移(见下文)
├─ story.md 不存在 → 询问作者是否初始化 → 是则执行 init.py
│ └─ python <本 skill 安装目录>/tools/init.py [project-path] [--genre <编号>] → 完成后 @novel-agent
└─ story.md 存在 → 已有项目
├─ story.md 含 length: short → 短篇项目 → @short-agent 继续写作(不进卷纲/章纲流程)
├─ 检查同步新鲜度
│ ├─ python <本 skill 安装目录>/tools/sync-project.py . --check → exit 0 → 已最新,略过
│ ├─ python <本 skill 安装目录>/tools/sync-project.py . --check → exit 1 → 有更新
│ │ └─ 展示变更文件,询问作者是否同步
│ │ ├─ 确认 → 运行 python <本 skill 安装目录>/tools/sync-project.py .
│ │ └─ 跳过 → 继续
│ └─ .agent/.sync-fingerprint 不存在(首次)
│ └─ 静默运行 python <本 skill 安装目录>/tools/sync-project.py . → 写入指纹
└─ → @novel-agent 继续写作
```
### 短篇分支(length: short)
作者在项目目录表达短篇意图时走本分支:
```
短篇意图 + story.md 不存在 → 询问是否创建【短篇】项目 → 确认后执行
│ python <本 skill 安装目录>/tools/init.py [project-path] --length short → 完成后 @short-agent
└─ story.md 存在且含 length: short → @short-agent 继续写作
```
- 短篇项目与长篇项目的目录、流程、agent 组完全独立(`stories/{slug}/` 篇目制,无卷纲/章纲/提示词)
- 短篇流程:定情绪 →(作者确认)→ 构思排纲 →(作者确认)→ 契约组装 → 契约审计 → 分批写作 → 去AI味精修 → 兑现度核对 → 验收交付 →(改稿或下一篇)
- 长篇项目(story.md 无 length: short)里作者想写短篇 → 提示另建短篇项目目录,不混用
- **可选工具(不进调度链,作者主动触发)**:作者说「扫个榜 / 看看什么火」进入 `short-scan`(市场选题);说「拆这篇 / 分析这篇爆款」进入 `short-analyze`(对标拆解,产出 `analysis/{书名}/` 供写作阶段召回)——两个工具的 SOP 在平台 skills 目录下,按各自 SOP 执行,不写 order、不占 phase
**强制规则:**
- `story.md` 不存在时,**先询问作者**是否要在此目录创建小说项目,确认后再运行 `init.py`
- 禁止未经确认直接执行 `init.py`
- 确认后必须运行 `init.py`,禁止手动创建目录结构替代
- **禁止在 skill 安装目录(含 `skills/awesome-novel` 路径)内运行 `init.py`** — 此目录是技能仓库,不是小说项目
- 如果当前目录是 skill 安装目录,应提示作者切换到目标目录后再执行
- `init.py` 执行完毕后,确认 `.agent/status.md` 与平台部署目录已生成(Claude Code → `.claude/agents/`;OpenCode → `.opencode/agents/`;Reasonix → `.reasonix/skills/`;Codex → `.codex/agents/`;ZCode → `.zcode/skills/`;dsh → `.dsh/skills/`;Grok Build → `.grok/agents/`),方可进入 novel-agent
- 如果 `init.py` 报错,必须先修复问题重新执行,不允许绕过
## 初始化 — 先询问,确认后执行,不可跳过
全新项目先询问作者是否初始化,确认后运行 `init.py`(项目路径可选,默认当前目录):
```
python <本 skill 安装目录>/tools/init.py [project-path] [--genre <编号>]
```
`<本 skill 安装目录>` 即本 SKILL.md 所在目录(如 `~/.claude/skills/awesome-novel/`、`~/.config/opencode/skills/awesome-novel/`、`~/.codex/skills/awesome-novel/`、`~/.zcode/skills/awesome-novel/`、`~/.dsh/skills/awesome-novel/`、`~/.grok/skills/awesome-novel/`)。AI 用绝对路径调用,避免在项目目录找不到 `tools/init.py`。
**禁止以任何理由跳过 init.py:** 手动创建目录、复制模板、直接调用 agent 都属于违规行为。`init.py` 是初始化入口,必须执行且完整运行。
`init.py` 会:
1. 选题材
2. 创建项目骨架(settings/、volumes/、chapters/、prompts/、archives/)
3. 部署 agent/skill 到当前平台约定目录(Claude Code → `.claude/agents/`;OpenCode → `.opencode/agents/`;Reasonix / ZCode / dsh 不部署 agents,agents 即 `.reasonix/skills/` / `.zcode/skills/` / `.dsh/skills/`;Codex → `.codex/agents/*.toml`;Grok Build → `.grok/agents/*.md`)
4. 按题材继承反 AI 规则和文风偏好到平台 knowledge 目录(`.claude/knowledge/` / `.opencode/knowledge/` / `.reasonix/knowledge/` / `.codex/knowledge/` / `.zcode/knowledge/` / `.dsh/knowledge/` / `.grok/knowledge/`)
5. 按题材继承格式规范、题材案例到平台 knowledge 目录
6. 创建空白的写作记忆文件(平台 memory 目录)
7. 创建永久记忆占位文件(平台 knowledge 目录)
8. 生成 CLAUDE.md(OpenCode / Reasonix 下同时生成 AGENTS.md)
9. 初始化状态文件 `.agent/status.md`
以上 9 步全部由 `init.py` 自动完成,AI 无需也不应手动干预。
**检查:** 运行后确认 `.agent/status.md` 存在且内容正确,方可进入 `@novel-agent`。
## 设定讨论 — novel-agent 与作者讨论后,由 updater 写入
`init.py` 完成后进入 `@novel-agent`,此时 `phase=setup`,按以下流程:
1. **novel-agent 检测到 setup 阶段**,与作者逐项讨论设定(世界观/角色/风格/题材)。如果作者需要帮忙取书名,参考 `knowledge/title-craft/index.md` 的方法论给出建议
2. 讨论完毕后,novel-agent **写 order 文件** `.agent/task/setting-update-order.md`
3. novel-agent 通过 **Agent 工具调用 updater**
4. **updater 读取 order**,写入 `settings/world-setting.md`、`settings/genre-setting.md`、`settings/character-setting/*.md` 等设定文件
5. updater 将 order 覆盖为 `status: DONE` 并结束
6. **novel-agent 确认 order 标记 DONE**(只代表写入完成),展示已写入的设定摘要给作者确认:文件清单(对照 order 的 outputs 逐项列出)+ 世界观/题材/角色/文风要点,参照 `docs/tutorial.md` 3.8 完成报告样式,面向作者用日常语言,结尾话术:"设定已写入 settings/。哪里不对直接说;没问题就说'可以',我开始规划卷纲。"
7. **作者明确确认("可以/没问题/就这样";或说"之前已确认过")→ 才可推进 phase → outline**,进入卷纲规划。作者要求修改 → novePregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.