AllanYiin Skills

多平台 SKILL.md skill 集合，主打繁體中文工作流、研究型任務與可工程化維護。這個 repo 面向 OpenClaw、ClawHub、Codex、Claude Code、Cursor，以及其他可讀取 SKILL.md 的 agent 環境。

這是什麼

• 可直接安裝或複製的 skill folders
• .skill 打包產物與 ClawHub 匯出
• repo 級 discovery / trust / packaging / publish audits
• 可生成的 catalog 與分類索引，方便人類與模型搜尋 skill

支援哪些 agent / 平台

• OpenClaw：優先支援 <workspace>/skills 與 ~/.openclaw/skills
• ClawHub：可由 dist/clawhub/<skill-name>/ 匯出後提交或安裝
• Codex / Claude Code / Cursor：可直接複製單一 skill 資料夾到工作區 skills/
• 其他 SKILL.md 相容代理：可直接使用 skill folder

最值得先裝的 skills

• concept-alignment：先查清關鍵概念、背景脈絡與近期事件，再開始主任務
• problem-decomposer：把大型、混亂或高不確定性的問題拆成可執行工作包
• technical-documentation-writer：撰寫、重寫與盤點 README、Quick Start、API guide、runbook、FAQ
• pptx-maker：把既有內容、模板或 SVG 真正落成可交付投影片
• skill-creator-advanced：建立、評估、發佈與迭代 skill，包含 discovery / trust 稽核
• web-search-strategy：把模糊研究題目拆成可執行的多輪搜尋查詢
• frontend-design：把網站、Web App 或元件需求落成可上線介面
• humanize-text：把 AI 味太重或翻譯腔內容改寫成自然語氣

安裝

直接使用單一 skill

把想用的 skill 資料夾放到目前工作區的 skills/，或 OpenClaw 的 ~/.openclaw/skills/。

git clone https://github.com/AllanYiin/skills.git
Copy-Item -Recurse .\skills\concept-alignment C:\path\to\workspace\skills\

產生 .skill 與 ClawHub 匯出

npx agent-skills-publisher build

這會先執行 repo 驗證，再輸出：

• dist/*.skill
• dist/clawhub/<skill-name>/skill.yaml

只處理單一 skill

npx agent-skills-publisher build --skill concept-alignment
python scripts/audit_openclaw_frontmatter.py
python scripts/audit_skill_references.py
python scripts/check_skill_name_surface.py

搜尋 skill

• 先看 catalog/skills.yaml，它會列出 archetype、category、triggers 與 negative boundaries
• 想找互搶 query 的技能，跑 python scripts/audit_skill_overlap.py
• 想檢查 repo 首頁、About 與 topics 是否一致，跑 python scripts/audit_repo_discovery.py
• 想重新生成 catalog，跑 python scripts/generate_catalog.py

分類索引

• Research：concept-alignment、web-search-strategy、longdoc-evidence-reader
• Problem solving：problem-decomposer、alternative-solution-designer、fermi-estimation
• Writing & documentation：technical-documentation-writer、longform-writing-process、humanize-text
• Presentation & diagrams：slide-content-planner、pptx-maker、mermaid-diagram
• Agent ops：skill-creator-advanced、mcp-http-diagnostics、vibe-coding-guidelines
• Product & UI：frontend-design、spec-organizer、ethical-persuasion-strategy

貢獻

新增或改版 skill 時，至少先做這幾步：

python scripts/validate_skills.py
python scripts/audit_openclaw_frontmatter.py
python scripts/audit_skill_references.py
python scripts/check_skill_name_surface.py
python scripts/audit_skill_overlap.py
python scripts/audit_repo_discovery.py
python scripts/generate_catalog.py
python -m unittest discover -s tests -p "test_*.py"

若要發佈 changed skills，再跑打包與發佈腳本。

維護者工作流

打包與匯出

python scripts/package_all_skills.py
python scripts/export_clawhub_skills.py
python scripts/export_changed_npm_skill_installers.py --base-ref origin/main --head-ref HEAD
python scripts/publish_changed_clawhub_skills.py --base-ref origin/main --head-ref HEAD --require-version-bump --dry-run

版本治理

• 每個 skill 使用自己的頂層 version: YYYY.M.D
• 只要 skill 內容有變更，就應 bump 該 skill 的版本
• 可用 python scripts/bump_skill_version.py --skill <skill-dir-name> 協助更新

Repo 結構

• skills：所有 skill folders
• catalog/skills.yaml：repo 級 skill catalog
• scripts：驗證、discovery、打包、匯出、版本治理與發佈工具
• tests：repo 級單元測試
• docs：維護說明與補充文件
• dist：打包輸出

License

MIT。詳見 LICENSE。