toutiao-publisher
Skill32 starsChanged 4 months agoMITView on GitHub
Publish or prepare articles for Toutiao/头条号, check or restore shared login state, fill Markdown drafts with inline images and covers, and optionally complete final publishing. Use for requests such as 发布到头条、检查头条登录、填充头条草稿、上传图文、人工审核 or explicitly authorized automatic publishing.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- Aias00/agent-skillstheir own version, first seen Mar 24, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- Aias00/agent-skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository9 other files it gives its agents.
- excalidraw-visual-designerSkill
- gif-makerSkill
- grid-sticker-generatorSkill
- sticker-factorySkill
- video-tutorial-makerSkill
- wechat-post-publisherSkill
- wechat-sticker-assets-designerSkill
- wechat-sticker-makerSkill
- template-skillSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 4 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Use the scripts from this Skill directory.
- Very specific: line 14
Default to --mode manual. Leave Chrome open for the user to review and click Publish.
- Very specific: line 15
Use --mode auto only when the user explicitly authorizes final publishing.
- Very specific: line 16
Run clear --yes or reauth --yes only after the user confirms that all local Agents may lose the shared Toutiao session.
- Distinctive: line 18
Do not bypass input validation or treat an unconfirmed publish click as success.
- Distinctive: line 22
Check the protected Toutiao page before asking the user to scan a QR code:
- Very specific: line 28
If the result status is not_authenticated, open the interactive login flow:
- Distinctive: line 52
After validation succeeds, fill the draft and wait for manual review:
- Very specific: line 63
Use direct text only through --content-text.
- Distinctive: line 95
Treat stderr as human-readable diagnostics.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Toutiao Publisher
Use the scripts from this Skill directory. Resolve the directory containing this
SKILL.md first and set its absolute path as SKILL_DIR; do not assume the caller's
working directory is the Skill directory.
Safety rules
- Default to
--mode manual. Leave Chrome open for the user to review and click Publish. - Use
--mode autoonly when the user explicitly authorizes final publishing. - Run
clear --yesorreauth --yesonly after the user confirms that all local Agents may lose the shared Toutiao session. - Do not bypass input validation or treat an unconfirmed publish click as success.
Preflight authentication
Check the protected Toutiao page before asking the user to scan a QR code:
python3 "$SKILL_DIR/scripts/run.py" auth_manager.py status --verify --jsonIf the result status is not_authenticated, open the interactive login flow:
python3 "$SKILL_DIR/scripts/run.py" auth_manager.py setup --jsonThe shared profile lives under ~/.super-publisher/toutiao-publisher/ by default.
Codex, Kiro, Antigravity, and direct CLI runs by the same system user reuse it.
Set SUPER_PUBLISHER_DATA_DIR to override the location; relative values resolve
from the user home directory.
Prepare and publish an article
Validate inputs without opening Chrome:
python3 "$SKILL_DIR/scripts/run.py" publisher.py \
--mode validate \
--title "AI Trends 2026" \
--content-file "/absolute/path/article.md" \
--cover "/absolute/path/cover.jpg" \
--jsonAfter validation succeeds, fill the draft and wait for manual review:
python3 "$SKILL_DIR/scripts/run.py" publisher.py \
--mode manual \
--title "AI Trends 2026" \
--content-file "/absolute/path/article.md" \
--cover "/absolute/path/cover.jpg" \
--jsonUse direct text only through --content-text. --content remains an alias for
--content-file; a missing path is an error rather than literal article text.
Markdown supports headings, links, ordered and unordered lists, block quotes,
tables, fenced code, inline code, emphasis, and local inline images. Resolve relative
image paths from the Markdown file. If the body contains images, skip explicit cover
upload. Use --no-cover only when the body has no image and no cover is supplied.
For explicitly authorized automatic publishing:
python3 "$SKILL_DIR/scripts/run.py" publisher.py \
--mode auto \
--title "AI Trends 2026" \
--content-file "/absolute/path/article.md" \
--headless \
--jsonAutomatic publishing succeeds only after Toutiao displays a recognized success
indicator. A final-button click without confirmation returns publish_unconfirmed.
Result contract
With --json, authentication commands write one JSON result to stdout. Publisher
commands write newline-delimited JSON events; manual mode emits
awaiting_manual_review before waiting for the user.
- Exit
0: authenticated, input valid, manual review completed, or publish confirmed. - Exit
1: runtime, browser interaction, draft, upload, or publish failure. - Exit
2: invalid input, missing authentication, or clear confirmation required.
Treat stderr as human-readable diagnostics. Do not parse emojis or prose to determine success.
Session management
# Read local state only
python3 "$SKILL_DIR/scripts/run.py" auth_manager.py status --json
# Verify against Toutiao and refresh state
python3 "$SKILL_DIR/scripts/run.py" auth_manager.py validate --json
# Destructive: require explicit user confirmation first
python3 "$SKILL_DIR/scripts/run.py" auth_manager.py clear --yes --jsonEnvironment
Require Python 3.9+, Google Chrome, and local network access. scripts/run.py
bootstraps scripts/setup_environment.py, verifies the requirements fingerprint,
and executes the target with the Skill-local .venv Python. The shared state directory
uses owner-only permissions. Avoid starting concurrent browser operations against the
same persistent Chrome Profile.
Enable --debug-screenshots only when troubleshooting. Screenshots are written under
output/toutiao-publisher-debug/ by default.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

