diff --git a/README.md b/README.md index 3dd2037..ae468cb 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,31 @@ Skills shared by Baoyu for improving daily work efficiency with AI Agents (Claud npx skills add jimliu/baoyu-skills ``` +### Codex Project-Level Install + +If you only need a subset of skills in one project, you do not need to install the full plugin. Codex scans `.agents/skills` inside a project, so copy or symlink each needed skill as a full directory: + +```text +/.agents/skills/baoyu-cover-image/SKILL.md +/.agents/skills/baoyu-article-illustrator/SKILL.md +/.agents/skills/baoyu-post-to-wechat/SKILL.md +``` + +For a WeChat Official Account article workflow, the usual minimal set is: + +- `baoyu-cover-image` +- `baoyu-article-illustrator` +- `baoyu-post-to-wechat` + +You do not need to install `baoyu-markdown-to-html` separately. `baoyu-post-to-wechat` already includes the Markdown to WeChat-ready HTML conversion flow. Install `baoyu-format-markdown` only if you need to first turn raw text or drafts into structured Markdown articles with titles, summaries, headings, bold text, lists, and similar formatting. + +Place WeChat API credentials according to the scope you want: + +- User-level: `~/.baoyu-skills/.env` +- Project-level: `/.baoyu-skills/.env` + +Project-level `.env` files are useful when credentials should apply only to the current project. Do not commit them to Git. + ### Publish to ClawHub / OpenClaw This repository now supports publishing each `skills/baoyu-*` directory as an individual ClawHub skill. diff --git a/README.zh.md b/README.zh.md index 701af9c..da20914 100644 --- a/README.zh.md +++ b/README.zh.md @@ -29,6 +29,31 @@ npx skills add jimliu/baoyu-skills ``` +### Codex 项目级安装 + +如果只在某个项目中使用部分技能,不需要安装整个插件。Codex 会扫描项目里的 `.agents/skills`,可以只把需要的 skill 按整个目录复制或软链接到当前项目: + +```text +/.agents/skills/baoyu-cover-image/SKILL.md +/.agents/skills/baoyu-article-illustrator/SKILL.md +/.agents/skills/baoyu-post-to-wechat/SKILL.md +``` + +公众号文章发布的最小组合通常是: + +- `baoyu-cover-image` +- `baoyu-article-illustrator` +- `baoyu-post-to-wechat` + +不需要单独安装 `baoyu-markdown-to-html`,`baoyu-post-to-wechat` 已内置 Markdown 到公众号可用 HTML 的转换流程。只有需要先把原始文本或草稿整理成 Markdown 文章结构(标题、摘要、层级标题、加粗、列表等)时,再额外安装 `baoyu-format-markdown`。 + +公众号 API 凭证按作用范围放置: + +- 全局:`~/.baoyu-skills/.env` +- 项目:`/.baoyu-skills/.env` + +项目级 `.env` 适合只给当前项目使用,注意不要提交到 Git。 + ### 发布到 ClawHub / OpenClaw 现在这个仓库支持把每个 `skills/baoyu-*` 目录作为独立 ClawHub skill 发布。