Guide · Agent skill
How to use the Story Publish Prep agent skill (story-publish)
Updated · written with AI from the project's own documentation and checked against our catalogue data
story-publish is an agent skill for Chinese web novel authors preparing a new book listing on the Fanqie (番茄小说) platform. It turns your existing story notes into the fields the platform's create-book form asks for, checks them against Fanqie reference lists, and saves a publish-info file in your book folder. This guide covers what the skill does, how to install it, how to trigger it, and what to check before you rely on its output.
Story Publish Prepzenstory-ai/oh-story-claudecode · MIT Download the skill Quick start
- 1Download and unzip. Download the story-publish ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder.
- 2Or upload in the Claude apps. In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the ZIP.
- 3Confirm Python 3 is available. The format check needs python3, python or py on your system.
- 4Make a request. Ask in plain language, for example 填写平台建书资料, or type /story-publish, naming your book if the folder is unclear.
- 5Answer the questions. Accept, change or leave open each suggested field. Only what you confirm becomes final.
- 6Review the saved file. Open 发布资料-番茄小说.md in your book folder and check the pending sections before you use the values on the platform.
What the skill makes the agent do
Agent skills are folders of instructions that an AI agent loads when a request matches them. The story-publish skill focuses on one job: preparing publish information. It reads your existing setting, outline and author decisions, then drafts a title, blurb, protagonist names, categories and tags for the platform form.
Each field is marked as confirmed, suggested, pending, or pending platform verification. Anything you have not explicitly accepted stays unconfirmed. The result is saved as a file named 发布资料-番茄小说.md in the book folder. The skill does not log in to the platform, fill in forms, submit, or publish.
- Works with long-form (长篇) and short-story (短故事) Fanqie books.
- Only Fanqie is currently supported; other platforms are explicitly marked as not adapted.
- Checks tags against the reference lists bundled with the skill, not from memory.
- Runs a read-only format check script after saving the file.
Install the story-publish skill
Download the skill ZIP from this page and unzip it. For a personal install, place the folder in ~/.claude/skills/. To limit it to one project, place it in that project's .claude/skills/ folder.
You can also upload the skill in the Claude apps: open Settings, go to Capabilities, then Skills, and upload the ZIP there.
- Personal: ~/.claude/skills/story-publish
- Single project: <your-project>/.claude/skills/story-publish
- Claude apps: Settings → Capabilities → Skills → upload the ZIP
~/.claude/skills/How to trigger the skill with natural requests
You can use the slash command /story-publish or /发布资料. You can also ask in plain language. The skill's description lists requests such as 填写平台建书资料, 建书表单, and 起书名/写简介/选标签用于发布. It also applies when the manuscript has reached about 20,000 Chinese characters and you are preparing to list it.
Name the book and platform in your request when you can. If the book folder is unclear, the agent will ask rather than guess from folder names.
- /story-publish
- /发布资料
- 填写平台建书资料
- 建书表单
- 起书名、写简介、选标签用于发布
What you need before you start
The skill needs Python 3 so the agent can run its format check script. The agent tries python3, then python, then py. Your book folder should contain the setting and outline files the skill reads, such as 设定/题材定位.md and 大纲/大纲.md for long-form books, or 设定.md and 小节大纲.md for short stories.
Cover generation is optional. It needs the separate story-cover skill and an image generation tool, which may require an API key.
- Python 3 available as python3, python or py
- Book folder with the setting and outline files
- Optional: story-cover skill plus an image generation tool (may need an API key)
Safety notes: scripts and network
The skill runs one script: scripts/check-publish-format.py. According to the skill's metadata, it runs scripts but does not use the network. The script is read-only: it checks the saved file and reports FAIL or WARN results without changing your content.
The agent will not change values you have already set, such as your title or pen name. Where a problem is found, it points it out and offers a suggestion. If the agent cannot run the script, it re-checks the file manually and tells you the automatic check did not run.
- Runs scripts: yes (check-publish-format.py, read-only)
- Uses network: no
- Never logs in, fills forms or publishes
- Does not overwrite an existing publish-info file without asking
Examples and tips for good results
A useful first request names the platform, the book type and the outcome you want, for example asking the agent to prepare Fanqie long-form listing fields for your book and check the tags. Keep your setting and outline files up to date, because the skill treats them as source material.
Treat the platform reference lists as a dated snapshot. The skill's files record a verification date and scope. Check the live Fanqie create-book form before you submit, since the site may have changed.
- Ask for a checklist of tags matched to platform options before you upload.
- Ask for a short submission blurb and tag set for a short story.
- Review every item under pending author confirmation before you accept it.
- Compare the final title with your setting file; the skill will tell you if they differ.
What people use it for
- Preparing a new Fanqie long-form book listing: title, blurb, protagonist names and category tags.
- Choosing tags that match the Fanqie candidate lists before you upload.
- Writing a tidy submission blurb and tag set for a Fanqie short story.
- Keeping a single publish-info file with confirmed, suggested and pending fields for later reference.
Frequently asked questions
Is story-publish free to use?
The source does not state a price or licence terms for the skill beyond its MIT licence noted on this page. Check the repository for the full licence text. Optional cover generation may need an API key from an image tool.
Which platforms does story-publish support?
Only Fanqie (番茄小说) is currently supported, with long-form and short-story reference files. Other platforms are explicitly marked as not adapted, and the skill asks you for a dated screenshot or official guide before giving platform-specific advice.
Does story-publish publish my book for me?
No. The skill states it does not log in to the platform, fill in forms, submit, or publish. Preparing the publish information is complete when the file is saved; it does not mean the book has been submitted.
What do I need to install story-publish?
Install the skill folder into ~/.claude/skills/ or a project's .claude/skills/, or upload the ZIP under Settings → Capabilities → Skills. Python 3 is needed for the format check script.
Why does the skill say the platform rules may be outdated?
The Fanqie reference lists are a snapshot verified on a dated basis and cover only the web create-book pop-up for tags. The live site may differ, so the skill asks you to confirm limits on the platform itself.
How does story-publish compare with writing tools?
The skill does not plan plots or write chapters. Its source says plot planning and drafting belong to writing skills such as story-long-write, while story-publish handles the listing fields and checks.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use story-publish if you write for Fanqie and want your listing fields and tags checked against platform reference lists, saved in one tidy file. Pick something else if you publish on another platform, want automatic submission, or need current rules guaranteed, since the skill's lists are a dated snapshot and it never publishes for you.
Download the skill