claude-writing-skills

A toolkit of Claude Code skills for long-form content creators — research, score, rewrite, and publish, end to end.

中文版: README.zh-CN.md

5 skills extracted from a real working writing setup. They are opinionated, narrow in scope, and meant to compose. Each one does one thing.

Skill descriptions (frontmatter) are English so they trigger correctly. Skill bodies are written in Chinese — that's the author's working language. If you don't read Chinese, the script files and command examples are still usable, and the descriptions tell you what each skill does. PRs translating bodies welcome.

Install

Add this repo as a Claude Code marketplace, then install:

/plugin marketplace add xiaomoBoy/claude-writing-skills
/plugin install claude-writing-skills@claude-writing-skills

That's it — you now have all 5 skills available.

Each skill may need its own upstream CLI (e.g. yt-dlp, nlm, codex, wechatsync). See INSTALL.md for the full per-OS install guide (macOS / Linux / Windows + verification + troubleshooting).

Not using Claude Code? See INTEGRATIONS.md for using these skills with Cursor, Aider, Codex CLI, the Claude API directly, or as standalone scripts.

What's inside

Skill	What it does	Depends on
research-collector	Collect YouTube videos + web articles for a topic, push into a NotebookLM notebook, run analysis queries, save results as markdown.	notebooklm-mcp-cli (nlm), yt-dlp
publisher-wechatsync	Publish a finished markdown article to 知乎 / 掘金 / CSDN / 公众号 etc. as drafts via the wechatsync CLI. Handles pre-flight checks, dry-run, and image-path normalization.	@wechatsync/cli + Chrome extension
article-optimizer	Score a single article against a fixed viral-content rubric, then iterate rewrites round by round to raise the score.	codex CLI
score-optimizer	Calibrate / improve the scoring rubric itself by batch-scoring a labeled sample set. The companion to article-optimizer when you want to tune the evaluator.	codex CLI
yt-dlp-direct	A pragmatic command-reference skill for the installed yt-dlp CLI — single videos, playlists, audio extraction, subtitles, cookies-from-browser. No reinvention, just operational knowledge.	yt-dlp

Why I built these

I write long-form articles on my own publication and cross-post to several Chinese platforms. After a year of doing it with Claude Code, I had accumulated maybe 30 ad-hoc prompts and shell helpers. These 5 skills are the parts that survived the consolidation — the ones I actually use every week.

Two design principles run through all of them:

1. One skill, one job. No "do the whole workflow" skills. The boundaries between research / scoring / rewriting / publishing are explicit and the skills refuse to cross them.
2. Real tools, not LLM-only. Where a CLI already does the job well (yt-dlp, nlm, wechatsync, codex), the skill wraps operational knowledge around it rather than reinventing in pure prompt.

If you want the writing workflow as a whole (idea → outline → draft → style alignment), it's deeply coupled to my personal vault and not part of this release. These 5 are the parts I could cleanly extract.

Per-skill quick start

research-collector

You: 帮我收集 "Claude Code skills" 这个话题的素材，输出到 ./research/claude-skills
Claude: [invokes research-collector] → creates notebook, adds ~15 YouTube + ~40 web sources,
        runs 3 analysis queries, saves summary markdown

publisher-wechatsync

You: 把 path/to/article.md 发到知乎和掘金（先 dry-run）
Claude: [invokes publisher-wechatsync] → checks auth, normalizes image paths,
        runs dry-run, asks confirmation, then syncs

article-optimizer / score-optimizer

You: 给 path/to/article.md 跑一遍评分
Claude: [invokes article-optimizer] → returns 9-dimension score JSON

You: 评分器对 "title_score" 给得太松，帮我校准
Claude: [invokes score-optimizer] → re-runs prompt on labeled samples, compares

yt-dlp-direct

You: 把这个 YouTube 播放列表的音频下下来
Claude: [invokes yt-dlp-direct] → constructs the exact yt-dlp invocation, runs it

Configuration

Most skills work with zero config. A few env vars are useful:

Variable	Used by	Purpose
CODEX_CLI_PATH	article-optimizer, score-optimizer	Override codex binary path if not on PATH
RESEARCH_OUTPUT_DIR	research-collector	Default output directory (default: ./research/<topic>/)
MD_VAULT_ROOT	publisher-wechatsync (image normalizer)	Fallback root for resolving relative image paths
WECHATSYNC_TOKEN	publisher-wechatsync	Required, from the Wechatsync Chrome extension

Requirements

• Claude Code (with skill / plugin support) — or any other agent runtime per INTEGRATIONS.md
• Per-skill CLI dependencies (nlm, yt-dlp, codex, wechatsync) — install only the ones for skills you use
• Python 3.9+ for the bundled scripts (standard library only — no pip deps)

For full install instructions across macOS / Linux / Windows, see INSTALL.md.

Repository layout

.claude-plugin/
  marketplace.json     # marketplace definition (one plugin)
  plugin.json          # plugin manifest
.github/
  ISSUE_TEMPLATE/      # bug + feature templates
  PULL_REQUEST_TEMPLATE.md
skills/
  research-collector/
  publisher-wechatsync/
  article-optimizer/
  score-optimizer/
  yt-dlp-direct/
docs/
  USAGE.md             # end-to-end walkthrough (EN)
  USAGE.zh-CN.md       # end-to-end walkthrough (ZH)
README.md              # this file
README.zh-CN.md        # Chinese landing
INSTALL.md             # dependency install guide (EN)
INSTALL.zh-CN.md       # dependency install guide (ZH)
INTEGRATIONS.md        # use outside Claude Code (EN)
INTEGRATIONS.zh-CN.md  # use outside Claude Code (ZH)
CONTRIBUTING.md        # how to contribute
CHANGELOG.md           # version history
LICENSE

Documentation index

Doc	What's in it
README.md / README.zh-CN.md	Landing page, quick install, what's inside
INSTALL.md / INSTALL.zh-CN.md	Detailed install of every CLI dependency, per OS
INTEGRATIONS.md / INTEGRATIONS.zh-CN.md	Use these skills with Cursor, Aider, Codex CLI, Claude API SDK, or standalone
docs/USAGE.md / docs/USAGE.zh-CN.md	End-to-end scenario walkthrough
CONTRIBUTING.md	Contribution workflow + design principles
CHANGELOG.md	Version history
Per-skill skills/<name>/SKILL.md	The actual playbook each skill follows
Per-skill skills/<name>/README.md	GitHub-friendly skill summary

Contributing

Issues and PRs welcome. See CONTRIBUTING.md for the workflow + design principles.

Highest-impact PRs right now:

• English translation of SKILL.md bodies — the descriptions trigger fine in English, but the body content (workflows, troubleshooting) is currently Chinese
• Integration recipes for other agent runtimes (LangChain, AutoGen, etc.) — add to INTEGRATIONS.md
• More worked examples in per-skill READMEs — especially for score-optimizer (the calibration loop is non-obvious if you haven't tried it)

If you build something on top of these or extract a new skill, link back — happy to feature it in the README.

License

MIT — see LICENSE.

Author

Built by @xiaomoBoy. I write about VPS, self-hosting, and AI workflows. If this is useful to you, a star helps me find time to keep maintaining it.