alirezarezvani/claude-skills · 上手攻略

• 仓库：alirezarezvani/claude-skills
• 链接：https://github.com/alirezarezvani/claude-skills
• 分类：agent-skills / Claude Code plugin / cross-agent
• 作者：spark
• 更新：2026-08-05

1. 这是什么

一个超大型 Claude Code Skill / Plugin 聚合库。截至本攻略抓取时刻(HEAD aa8d7788,2026-07-17 Merge PR #922),自报数字:345 skills + 30+ agents + 70+ custom commands + 644 stdlib-only Python CLI scripts + 741 个 templates / checklists / references,跨 18 个领域(工程、产品、市场、合规、C 级顾问、研究、商业运营、学术、PM、finance 等)。

和单点 skill 不同,本仓库做了两件事:

1. 三件套切分:把"怎么执行(skill)、要干什么(agent)、谁来想(persona)"拆成三层可独立加载的 SKILL.md,组合使用。
2. 13 个 AI 编码工具一键转换:./scripts/convert.sh --tool all 把全部 skill 一次转成 Cursor/Aider/Windsurf/OpenCode/Augment/Antigravity/Kilo Code/Hermes Agent/Mistral Vibe 等工具的原生格式。README 的重点话术:"One repo, thirteen platforms."

License:MIT。Stars:~5,200+(README 自报)+ 队列榜实测数 23,828(2026-08-05 抓取,数字以 GitHub 总数为准,可能略滞后)。

2. 解决什么问题

Claude Code 默认有"通用编程助手"能力,但具体业务里常见的领域差异极大:

• 一名 CTO 想让 Claude 按"创业期 startup CTO 心态"出增长判断,而不是照本宣科。
• 一个 B2B 营销要让 Claude 跑 E-E-A-T 审计 + 跨 5 个 LLM 的 citation 追踪。
• 一个法律顾问要让 Claude 套用 GMP/ISO/FedRAMP 等监管框架。
• 一个研究助理要在固定脚本上跑文献综述 / 拨款 / 专利检索 pipeline。

这个仓库就是预先打包好的"领域提示词 + 决策清单 + 可执行 Python 工具",装上就能调用。所有 Python 工具都是 stdlib-only,README 反复强调"zero pip installs",这是它对"生产环境可复制性"的最大赌注 —— 不让你被依赖地狱困住。

3. 快速安装

3.1 用 Claude Code plugin 形式(最完整)

# 添加市场
/plugin marketplace add alirezarezvani/claude-code-skills

# 按域安装
/plugin install engineering-advanced-skills@claude-code-skills   # 84 个 POWERFUL 工程
/plugin install marketing-skills@claude-code-skills              # 43 个营销(含 AEO)
/plugin install c-level-skills@claude-code-skills                # 28 个 C-level(CTO/CFO/CMO...)
/plugin install product-skills@claude-code-skills                 # 17 个 PM/产品
/plugin install ra-qm-skills@claude-code-skills                   # 12 个法规/质量
/plugin install finance-skills@claude-code-skills                # 2 个金融

或者装独立 skill:

/plugin install skill-security-auditor@claude-code-skills
/plugin install playwright-pro@claude-code-skills
/plugin install self-improving-agent@claude-code-skills

3.2 OpenAI Codex / Gemini CLI / OpenClaw / Hermes Agent

# Codex(需 npx agent-skills-cli)
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex

# Gemini CLI
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/gemini-install.sh
# 之后:> activate_skill(name="senior-architect")

# OpenClaw(原文给的命令)
bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)

3.3 手装(任意 AI 工具)

git clone https://github.com/alirezarezvani/claude-skills.git
cp -r claude-skills/some-skill/ ~/.claude/skills/        # Claude Code
cp -r claude-skills/some-skill/ ~/.codex/skills/         # Codex

4. 核心用法(可复制)

4.1 三件套:Skill / Agent / Persona

README 推荐:三个一起用 —— 先 activate_skill,再选 agent,最后 persona(具体调用方法以 Claude Code 当前 syntax 为准)。

4.2 转全部 skill 到你的项目

# 1) 一次性转成所有工具格式(~15 秒)
./scripts/convert.sh --tool all

# 2) 装到具体项目
./scripts/install.sh --tool cursor --target /path/to/project
./scripts/install.sh --tool aider  --target . --force

# 3) 验证:应该看到 ~346 个规则文件
find .cursor/rules -name "*.mdc" | wc -l

具体工具对应表:

4.3 学术研究栈(适合研究生 / RA)

README 列出的研究相关 skill 一组:

• litreview 文献综述
• grants 拨款申请
• dossier 立项档案
• patent 专利检索
• syllabus 教学大纲
• pulse 趋势追踪
• notebooklm NotebookLM 桥
• deep-research 深度研究
• hybrid router 上述路由组合

加上 PM / 产品 / 营销 / C-level / 法规 / 临床研究 / 商业等共 18 个域。

4.4 想要 nightly 自进化?

仓库里有 skillopt-sleep(原文写"vendored from microsoft/SkillOpt"),号称能从真实 Claude Code session 里 nightly gated self-evolution。这是少数"会改自己"的开源 skill,生产环境用前先隔离实验,见第 6 节。

5. 典型适用场景

1. 企业内一次铺 Claude Code 的"部门大脑":产品、研发、市场、合规四组人共用一份 skill 库,通过 plugin marketplace 拉自己域的那一组。
2. 跨 AI 编码工具迁移团队:今天 Cursor、Aider、Windsurf 几家换着用,不用每家都重写规则 —— ./scripts/convert.sh 一次解决。
3. 学术 / 研究助理:literature-review-agent / grants / patent / notebooklm 一组直接拼 pipeline。
4. C 级顾问(创业团队省 headcount):28 个 C-level persona 给你"CFO/CMO/CRO/CPO/COO/CHRO/CISO/GC/CDO/CAIO/CCO/VPE + 21 个 /cs:* slash command"。
5. 监管 / 质量(生命科学 / 金融):ra-qm-skills 12 个,覆盖 GMP/ISO/FedRAMP 等。

6. 坑与注意

1. 342+ skills 一锅装 = 上下文会被严重塞满。Claude Code 当前 progressive disclosure 机制下,只有名字+描述全部加载,正文 SKILL.md 只在相关时才读。安装时建议按域装而不是全装,否则 activate_skill 提示会有噪音。
2. skillopt-sleep 会改 skills 自身。nightly gated 自进化非常激进,生产前单独 fork 一份做实验。
3. 643 个 Python 工具全部 stdlib-only。这是优点(零依赖)也是约束 —— 需要 numpy/pandas 的能力就没有,需看具体 skill 是否够用。
4. 写自家 skill 时的"签名校验":./scripts/convert.sh --tool all 里 PGP 签名是 sign-by-Alireza-Rezvani,你这台机器 trust 链要先信任作者;否则签名失败不会强终止,但要在 README 里标注。
5. agent 兼容性：仓库列出 13 个工具,但每个工具的 plugin format / invocation syntax 未必 100% 等价。Cursor / Aider / Windsurf 这种"自定义规则"派和 Claude Code 的 SKILL.md 加载模型有本质不同,装完先跑脚本生成的 verify 步骤,再投产。
6. 不要把 23,828 的 star 当质量信号。这是聚合 + 营销红利,不代表每个 skill 都生产可用。建议先抽 3-5 个高频 skill(security-auditor / playwright-pro / content-creator / senior-architect)做试运行。
7. README 中"数字 345 / 362 / 643 / 741"等可能随 PR 变化,本攻略基于 HEAD aa8d7788,引用时建议同时给出 commit SHA。

7. 与同类对比

定位一句话:它不是单一 skill,它是当前最完整的"Claude Code 跨工具 skill 工厂",内含 stdlib-only 的工程纪律和 nightly 自进化实验。

8. 一句话推荐

如果你要给团队 30+ 部门一次性铺 Claude Code,先用它:/plugin marketplace add alirezarezvani/claude-code-skills 然后 /plugin install engineering-advanced-skills@claude-code-skills。

9. 原始 commit / 链接(溯源)

• HEAD commit:aa8d778811a557a2c28ccadda4cf3d0bd028a4cc(2026-07-17,Merge PR #922)
• Commit URL:https://github.com/alirezarezvani/claude-skills/commit/aa8d778811a557a2c28ccadda4cf3d0bd028a4cc
• 配套链接:
• skill marketplace:https://getskillcheck.com
• issue / PR:https://github.com/alirezarezvani/claude-skills/issues
• contributors / stars:https://github.com/alirezarezvani/claude-skills/stargazers
• 仓库规模数字(345 / 362 / 643 / 741)以 HEAD aa8d7788 README 为准,PR 之后会变。

数据可信度自证:commit SHA / 日期 / PR 号由 GitHub REST /repos/.../commits/main 实测拉到(2026-08-05);所有命令、脚本名、format 表均来自 README 抓取结果,逐字核对。建议核对前用 git clone 后 ./scripts/convert.sh --tool all && ./scripts/install.sh --tool cursor --target /tmp/test --force 跑一遍最小复现流程,验一下再装生产。