bookflow-skill
A Codex and Claude skill for short Chinese fiction from topic choice to release and review: the human decides, AI speeds up
- 210 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill works with text and prompts and does not publish or pay
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/bookflow-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill works with text and prompts and does not publish or pay
This is third-party code. Review the repository files before installing.
What it does
bookflow-skill takes a short novel through ten steps: topic choice, screening, project setup, characters, chapter plan, text in parts, editing against the AI manner, a publication package, checks and a review after release. Topics are tuned for the Fanqie (Tomato) platform: women's fiction, relationship dramas, historical twists and rule-based mystery. Every step has an input, an output and a point where the human decides. The skill keeps the original draft and prompt versions and does not publish, sign contracts, pay or submit personal data: the user does that on the platform. Alongside sit `references/factory/` with production materials and `references/bookflow-prompts/` with the working BookFlow prompts.
Who it is for. Authors of short Chinese-language novels and editors who run a series of projects on Fanqie and want a repeatable process instead of one-off generation.
Good fit when
- There is a plot idea that must be scored on four criteria before the text work starts
- A chapter plan is needed with a conflict, an emotion and a hook at the end of each
- A draft reads as generated and must be rewritten with concrete actions and lines
- Before publication a package is needed: blurb, title variants, tags and a cover description
Not a fit when
- You do not write in Chinese or for Fanqie: topics and scoring are tuned for that platform
- Automatic publishing or payments are needed, and the skill does not do them
- A long novel is required: the process is built for short form
Example request
Use $bookflow-skill to turn this story idea into a scored short-fiction project.Limitations
Materials and texts in the skill are in Chinese, while the description in `SKILL.md` is in English. The skill works on its own, and the full cycle with projects and a Kanban board needs a local BookFlow. The API key is stored there as a mask, and an Anthropic Messages or OpenAI-compatible endpoint is configured. Platform rules change, so the skill does not treat the 6000-character threshold and other conditions as permanent and asks to check current rules. The latest commit in the repository is from September 2026.
How to disable. Delete the skill folder from your agent's skills directory, for example `~/.codex/skills/bookflow-skill`. Projects created in BookFlow live separately and stay.
FAQ
How do I enable the skill?
Place the repository as a skill folder in the agent skills directory and invoke it with a phrase like `Use $bookflow-skill to turn this story idea into a scored short-fiction project`.
What does the process include?
Ten steps: topic, screening, project, characters, chapter plan, text, editing against the AI manner, publication package, checks and a post-release review on 24-hour, 72-hour and 7-day data.
Does the skill publish by itself?
No. Auto-publishing, signing contracts, payments and submitting personal data are not done by the skill: the user does them on the platform.
Is BookFlow required?
Not for the skill itself. A local BookFlow adds projects, a Kanban board and chapter writing, and process phases are mapped to its screens in `references/workflow-map.md`.
Which genres is it built for?
Women's fiction, breakup and return stories, historical twists and rule-based mystery. The process fits other genres less well.
Discussion
No questions or reviews yet.
Related
SkillsA skill helps Codex plan Chinese web fiction, revise scenes and check character actions against earlier chapters
A skill for multi-volume novels: 30-plus protocol files keep world, characters and style consistent from chapter to chapter
A Codex skill that takes a novel from idea to finished book, keeping plan, chapters and continuity in Markdown files.
Human Writing
human-writing
A skill for lively Chinese writing: helps the agent write and edit so a specific person seems to speak, not a model
Humanities Writing Companion walks a humanities paper through 12 modes: from sharpening the research question to a blind read and AI-use disclosure
15 skills for Codex that cover Xiaohongshu content from account research and topic choice to title, draft and pre-publish QA
README in short
The README briefly states the goal, the material sources, use cases, how to call it in Codex, the link to BookFlow and the principles: the human owns decisions, every step has an input and output, and a rollback remains before publishing.