claude-skills-library-expert

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Claude Skills Library Expert

Claude Skills 库专家

Skill by ara.so — Claude Code Skills collection.

Expert in using, installing, and contributing to the

alirezarezvani/claude-skills

repository — the most comprehensive open-source library of AI coding agent skills with 268+ production-ready skills across 9 domains (engineering, marketing, product, compliance, C-level advisory, etc.).

由ara.so开发的技能——Claude Code技能合集。

精通

alirezarezvani/claude-skills

仓库的使用、安装与贡献，这是目前最全面的AI编码Agent技能开源库，包含9大领域（工程、营销、产品、合规、高管咨询等）的268+可用于生产环境的技能。

What This Project Does

项目功能介绍

The claude-skills library provides modular instruction packages (skills) that give AI coding agents domain expertise they don't have out of the box. Each skill includes:

SKILL.md — structured instructions, workflows, decision frameworks
Python tools — 373 CLI scripts (stdlib-only, zero pip installs)
Reference docs — templates, checklists, domain-specific knowledge

Multi-tool support: Works natively with Claude Code, OpenAI Codex, Gemini CLI, and converts to 9+ other tools (Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, Antigravity, Hermes Agent).

claude-skills库提供模块化指令包（技能），为AI编码Agent赋予其原生不具备的领域专业能力。每个技能包含：

SKILL.md — 结构化指令、工作流程、决策框架
Python工具 — 373个CLI脚本（仅依赖标准库，无需pip安装）
参考文档 — 模板、检查表、领域专属知识

多工具支持： 原生兼容Claude Code、OpenAI Codex、Gemini CLI，还可转换为9+其他工具的适配格式（Cursor、Aider、Windsurf、Kilo Code、OpenCode、Augment、Antigravity、Hermes Agent）。

Installation

安装方法

Claude Code (Recommended)

Claude Code（推荐）

bash

undefined

bash

undefined

Add the marketplace

添加市场源

/plugin marketplace add alirezarezvani/claude-skills

Install by domain

按领域安装

/plugin install engineering-skills@claude-code-skills /plugin install marketing-skills@claude-code-skills /plugin install product-skills@claude-code-skills /plugin install c-level-skills@claude-code-skills

Install individual skills

安装单个技能

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

undefined

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

undefined

Gemini CLI

bash

git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/gemini-install.sh

bash

git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/gemini-install.sh

Activate a skill

激活技能

activate_skill(name="senior-architect")

undefined

activate_skill(name="senior-architect")

undefined

OpenAI Codex

bash

npx agent-skills-cli add alirezarezvani/claude-skills --agent codex

bash

npx agent-skills-cli add alirezarezvani/claude-skills --agent codex

OpenClaw

bash

bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)

bash

bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)

Manual Installation

手动安装

bash

git clone https://github.com/alirezarezvani/claude-skills.git

bash

git clone https://github.com/alirezarezvani/claude-skills.git

Copy skill folders to:

将技能文件夹复制到对应路径：

- Claude Code: ~/.claude/skills/

- Codex: ~/.codex/skills/

- Gemini CLI: ~/.gemini/skills/

undefined

undefined

Converting Skills to Other Tools

将技能转换为其他工具适配格式

The library supports 12 AI coding tools via conversion scripts.

该库通过转换脚本支持12种AI编码工具。

Convert All Skills to All Tools

将所有技能转换为所有工具格式

bash

cd claude-skills
./scripts/convert.sh --tool all

This generates tool-specific outputs in:

```
.cursor/
```
— Cursor
```
.mdc
```
rules
```
.aider/
```
— Aider
```
CONVENTIONS.md
```
```
.kilocode/
```
— Kilo Code rules
```
.windsurf/
```
— Windsurf skills
```
.opencode/
```
— OpenCode skills
```
.augment/
```
— Augment rules
```
~/.gemini/antigravity/
```
— Antigravity skills
```
~/.hermes/
```
— Hermes Agent skills

bash

cd claude-skills
./scripts/convert.sh --tool all

转换后会生成各工具专属的输出文件，存放路径：

```
.cursor/
```
— Cursor的
```
.mdc
```
规则文件
```
.aider/
```
— Aider的
```
CONVENTIONS.md
```
文件
```
.kilocode/
```
— Kilo Code规则文件
```
.windsurf/
```
— Windsurf技能文件
```
.opencode/
```
— OpenCode技能文件
```
.augment/
```
— Augment规则文件
```
~/.gemini/antigravity/
```
— Antigravity技能文件
```
~/.hermes/
```
— Hermes Agent技能文件

Install Converted Skills into a Project

将转换后的技能安装到项目中

bash

undefined

bash

undefined

Install with confirmation

确认后安装

./scripts/install.sh --tool cursor --target /path/to/project

Force install without confirmation

强制安装（无需确认）

./scripts/install.sh --tool aider --target . --force

undefined

./scripts/install.sh --tool aider --target . --force

undefined

Tool-Specific Conversion

针对特定工具的转换

bash

undefined

bash

undefined

Cursor

./scripts/convert.sh --tool cursor ./scripts/install.sh --tool cursor --target .

Aider

./scripts/convert.sh --tool aider ./scripts/install.sh --tool aider --target .

Windsurf

./scripts/convert.sh --tool windsurf ./scripts/install.sh --tool windsurf --target .

Hermes Agent

python scripts/sync-hermes-skills.py --verbose

undefined

python scripts/sync-hermes-skills.py --verbose

undefined

Verify Installation

验证安装结果

bash

undefined

bash

undefined

Cursor

find .cursor/rules -name "*.mdc" | wc -l # Should show 268

find .cursor/rules -name "*.mdc" | wc -l # 应显示268

Aider

cat CONVENTIONS.md # Should contain all skills

cat CONVENTIONS.md # 应包含所有技能内容

Windsurf

ls -1 .windsurf/skills/ | wc -l # Should show 268

undefined

ls -1 .windsurf/skills/ | wc -l # 应显示268

undefined

Key Skills and Domains

核心技能与领域

Engineering (32 core + 40 POWERFUL)

工程领域（32个核心技能 + 40个进阶技能）

bash

undefined

bash

undefined

Core skills

核心技能

/plugin install senior-architect@claude-code-skills /plugin install senior-frontend@claude-code-skills /plugin install senior-backend@claude-code-skills /plugin install devops-engineer@claude-code-skills /plugin install playwright-pro@claude-code-skills

POWERFUL tier

进阶技能

/plugin install agent-designer@claude-code-skills /plugin install rag-architect@claude-code-skills /plugin install database-designer@claude-code-skills /plugin install ci-cd-pipeline-builder@claude-code-skills /plugin install skill-security-auditor@claude-code-skills

undefined

undefined

Marketing (44 skills)

营销领域（44个技能）

bash

/plugin install marketing-skills@claude-code-skills

bash

/plugin install marketing-skills@claude-code-skills

Individual pods

细分模块

Content (8), SEO (5), CRO (6), Channels (6), Growth (4), Intelligence (4), Sales (2)

内容创作（8个）、SEO优化（5个）、转化率优化（6个）、渠道运营（6个）、增长策略（4个）、市场情报（4个）、销售支持（2个）

undefined

undefined

Product (13 skills)

产品领域（13个技能）

bash

/plugin install product-skills@claude-code-skills

bash

/plugin install product-skills@claude-code-skills

Includes: product-manager, agile-po, ux-researcher, ui-design, analytics-tracking, etc.

包含：产品经理、敏捷产品负责人、UX研究员、UI设计、数据分析追踪等技能

undefined

undefined

C-Level Advisory (28 skills)

高管咨询领域（28个技能）

bash

/plugin install c-level-skills@claude-code-skills

bash

/plugin install c-level-skills@claude-code-skills

Full C-suite: CTO, CMO, CFO, CRO, CPO, COO, CHRO, CISO, GC, CAIO

覆盖全套高管角色：CTO、CMO、CFO、CRO、CPO、COO、CHRO、CISO、总法律顾问、CAIO

undefined

undefined

Using Personas

使用角色功能

Personas are pre-configured agent identities with curated skill loadouts and distinct communication styles.

角色是预先配置的Agent身份，包含精选技能组合与独特沟通风格。

Available Personas

可用角色

startup-cto — Architecture decisions, tech stack, team building
growth-marketer — Content-led growth, launch strategy, channel optimization
solo-founder — Cross-domain, MVP building, wearing all hats

startup-cto — 架构决策、技术栈选型、团队搭建
growth-marketer — 内容驱动增长、发布策略、渠道优化
solo-founder — 跨领域能力、MVP搭建、身兼多职

Install a Persona

安装角色

bash

undefined

bash

undefined

Claude Code

cp agents/personas/startup-cto.md ~/.claude/agents/

For other tools, convert first

其他工具需先转换格式

./scripts/convert.sh --tool cursor

undefined

./scripts/convert.sh --tool cursor

undefined

Use a Persona

使用角色

markdown

undefined

markdown

undefined

In your conversation with the AI agent:

在与AI Agent的对话中输入：

"I want you to act as the Startup CTO persona. Review my architecture decisions for this new feature."

undefined

"我希望你以Startup CTO角色行动。帮我审查这个新功能的架构决策。"

undefined

Orchestration Patterns

编排模式

Orchestration coordinates personas, skills, and agents across domain boundaries.

编排用于跨领域协调角色、技能与Agent的协作。

Four Patterns

四种编排模式

1. Solo Sprint — Switch personas across project phases

markdown

Week 1-2: startup-cto + aws-solution-architect
Week 3-4: growth-marketer + launch-strategy
Week 5-6: solo-founder + analytics-tracking

2. Domain Deep-Dive — One persona + multiple stacked skills

bash

undefined

1. 单人冲刺 — 在项目不同阶段切换角色

markdown

第1-2周：startup-cto + aws-solution-architect
第3-4周：growth-marketer + launch-strategy
第5-6周：solo-founder + analytics-tracking

2. 领域深耕 — 单个角色叠加多个技能

bash

undefined

Example: Security audit

示例：安全审计

/activate persona startup-cto /use skill-security-auditor /use aws-solution-architect /use compliance-automation


**3. Multi-Agent Handoff** — Personas review each other's output
```markdown
1. startup-cto designs architecture
2. devops-engineer reviews deployment strategy
3. skill-security-auditor audits the plan

4. Skill Chain — Sequential skills, no persona needed

bash

undefined

/activate persona startup-cto /use skill-security-auditor /use aws-solution-architect /use compliance-automation


**3. 多Agent协作** — 角色互相审查输出
```markdown
1. startup-cto设计架构
2. devops-engineer审查部署策略
3. skill-security-auditor审计方案

4. 技能链 — 按顺序使用技能，无需角色

bash

undefined

Content pipeline

内容流水线

/use copywriting → /use seo-content-optimizer → /use email-sequence


See `orchestration/ORCHESTRATION.md` for full protocol and examples.

/use copywriting → /use seo-content-optimizer → /use email-sequence


完整协议与示例请查看`orchestration/ORCHESTRATION.md`。

Creating a New Skill

创建新技能

Skill Structure

技能结构

my-skill/
├── SKILL.md          # Main instruction file
├── scripts/          # Python tools (optional)
│   └── tool.py
├── references/       # Documentation (optional)
│   └── guide.md
└── templates/        # Templates (optional)
    └── template.txt

my-skill/
├── SKILL.md          # 主指令文件
├── scripts/          # Python工具（可选）
│   └── tool.py
├── references/       # 参考文档（可选）
│   └── guide.md
└── templates/        # 模板文件（可选）
    └── template.txt

SKILL.md Template

SKILL.md模板

yaml

---
name: my-skill
description: One-line description of what this skill does
triggers:
  - "phrase a user might say"
  - "another trigger phrase"
  - "how do I..."
  - "show me..."
---

yaml

---
name: my-skill
description: 技能功能的单行描述
triggers:
  - "用户可能说出的短语"
  - "另一个触发短语"
  - "如何..."
  - "展示..."
---

My Skill

我的技能

Skill by ara.so — Claude Code Skills collection.

由ara.so开发的技能——Claude Code技能合集。

Overview

概述

What this skill does and when to use it.

该技能的功能与适用场景。

Key Capabilities

核心能力

Capability 1
Capability 2

能力1
能力2

Usage

使用方法

How to use this skill with code examples.

包含代码示例的技能使用说明。

Workflows

工作流程

Step-by-step workflows.

分步工作流程。

Troubleshooting

故障排除

Common issues and solutions.

undefined

常见问题与解决方案。

undefined

Python Tool Template

Python工具模板

python

#!/usr/bin/env python3
"""
Description of what this tool does.
"""
import sys
import json
import os

def main():
    # Use environment variables for configuration
    config = os.getenv('MY_CONFIG', 'default_value')
    
    # Your tool logic here
    result = {"status": "success"}
    
    # Output JSON for easy parsing
    print(json.dumps(result, indent=2))

if __name__ == "__main__":
    main()

python

#!/usr/bin/env python3
"""
工具功能描述。
"""
import sys
import json
import os

def main():
    # 使用环境变量配置
    config = os.getenv('MY_CONFIG', 'default_value')
    
    # 工具逻辑代码
    result = {"status": "success"}
    
    # 输出JSON格式便于解析
    print(json.dumps(result, indent=2))

if __name__ == "__main__":
    main()

Add Your Skill

添加自定义技能

bash

undefined

bash

undefined

1. Create skill directory

1. 创建技能目录

mkdir -p my-skill/scripts

2. Write SKILL.md and scripts/tool.py

2. 编写SKILL.md和scripts/tool.py

3. Test locally

3. 本地测试

cp -r my-skill ~/.claude/skills/

4. (Optional) Submit PR to claude-skills repo

4.（可选）提交PR到claude-skills仓库

git checkout -b add-my-skill git add my-skill/ git commit -m "Add my-skill" git push origin add-my-skill

undefined

git checkout -b add-my-skill git add my-skill/ git commit -m "Add my-skill" git push origin add-my-skill

undefined

Common Patterns

常见使用模式

Using Python Tools from Skills

在技能中调用Python工具

All 373 Python tools are stdlib-only and can run anywhere:

python

#!/usr/bin/env python3

所有373个Python工具仅依赖标准库，可在任意环境运行：

python

#!/usr/bin/env python3

Example: engineering-team/playwright-pro/scripts/generate-test.py

示例：engineering-team/playwright-pro/scripts/generate-test.py

import sys import json

def generate_test(page_url, selectors): """Generate a Playwright test from URL and selectors.""" test_code = f""" import {{ test, expect }} from '@playwright/test';

test('test {page_url}', async ({{ page }}) => {{ await page.goto('{page_url}'); await expect(page.locator('{selectors[0]}')).toBeVisible(); }}); """ return test_code

if name == "main": url = sys.argv[1] if len(sys.argv) > 1 else "https://example.com" selectors = sys.argv[2:] if len(sys.argv) > 2 else ["body"] print(generate_test(url, selectors))


**Usage:**
```bash
python engineering-team/playwright-pro/scripts/generate-test.py \
  "https://myapp.com/login" \
  "input[name='email']" \
  "button[type='submit']"

import sys import json

def generate_test(page_url, selectors): """根据URL和选择器生成Playwright测试用例。""" test_code = f""" import {{ test, expect }} from '@playwright/test';

test('test {page_url}', async ({{ page }}) => {{ await page.goto('{page_url}'); await expect(page.locator('{selectors[0]}')).toBeVisible(); }}); """ return test_code

if name == "main": url = sys.argv[1] if len(sys.argv) > 1 else "https://example.com" selectors = sys.argv[2:] if len(sys.argv) > 2 else ["body"] print(generate_test(url, selectors))


**使用方式：**
```bash
python engineering-team/playwright-pro/scripts/generate-test.py \
  "https://myapp.com/login" \
  "input[name='email']" \
  "button[type='submit']"

Stacking Skills

技能叠加使用

bash

undefined

bash

undefined

Claude Code

/use senior-architect /use aws-solution-architect /use skill-security-auditor

Then ask:

然后提问：

"Review my architecture for a multi-tenant SaaS with SOC 2 compliance requirements."

undefined

"帮我审查一个符合SOC 2合规要求的多租户SaaS架构。"

undefined

Using Skills with Code Generation

结合技能生成代码

markdown

User: "Generate a REST API with CRUD operations for a blog post resource."

AI (with senior-backend skill):
- Analyzes requirements
- Follows RESTful patterns from skill
- Generates code with proper validation
- Includes security best practices
- Adds tests and documentation

markdown

用户："生成一个支持CRUD操作的博客文章资源REST API。"

AI（加载senior-backend技能后）：
- 分析需求
- 遵循技能中的RESTful规范
- 生成带有正确验证的代码
- 包含安全最佳实践
- 添加测试用例与文档

Troubleshooting

故障排除

Skills Not Loading

技能无法加载

Claude Code:

bash

undefined

Claude Code：

bash

undefined

Check installation

检查安装情况

ls ~/.claude/skills/

Reinstall

重新安装

/plugin uninstall my-skill@claude-code-skills /plugin install my-skill@claude-code-skills


**Gemini CLI:**
```bash

/plugin uninstall my-skill@claude-code-skills /plugin install my-skill@claude-code-skills


**Gemini CLI：**
```bash

Check installation

检查安装情况

ls ~/.gemini/skills/

Reinstall

重新安装

./scripts/gemini-install.sh

undefined

./scripts/gemini-install.sh

undefined

Conversion Script Fails

转换脚本执行失败

bash

undefined

bash

undefined

Ensure you're in the repo root

确保当前处于仓库根目录

cd /path/to/claude-skills

Check Python version (requires 3.7+)

检查Python版本（需要3.7+）

python3 --version

Run with verbose output

启用详细输出执行

./scripts/convert.sh --tool cursor --verbose

undefined

./scripts/convert.sh --tool cursor --verbose

undefined

Python Tools Not Executable

Python工具无法执行

bash

undefined

bash

undefined

Make scripts executable

为脚本添加执行权限

find . -name "*.py" -type f -exec chmod +x {} ;

Or run with python3 explicitly

或直接用python3运行

python3 engineering-team/playwright-pro/scripts/generate-test.py

undefined

python3 engineering-team/playwright-pro/scripts/generate-test.py

undefined

Persona Not Activating

角色无法激活

bash

undefined

bash

undefined

Ensure persona file is in correct location

确保角色文件在正确路径

Claude Code

cp agents/personas/startup-cto.md ~/.claude/agents/

For other tools, convert first

其他工具需先转换格式

./scripts/convert.sh --tool cursor

Verify file exists

验证文件存在

cat ~/.claude/agents/startup-cto.md

undefined

cat ~/.claude/agents/startup-cto.md

undefined

Skill Security Concerns

技能安全顾虑

Use the

skill-security-auditor

before installing third-party skills:

bash

undefined

安装第三方技能前，使用

skill-security-auditor

进行审计：

bash

undefined

Install the security auditor

安装安全审计技能

/plugin install skill-security-auditor@claude-code-skills

Audit a skill directory

审计技能目录

/use skill-security-auditor "Audit the skills in /path/to/untrusted-skills/"

undefined

/use skill-security-auditor "审计/path/to/untrusted-skills/目录下的技能"

undefined

Configuration

配置说明

Environment Variables

环境变量

Skills respect these environment variables:

bash

undefined

技能支持以下环境变量配置：

bash

undefined

General

通用配置

export CLAUDE_SKILLS_PATH="$HOME/.claude/skills" export GEMINI_SKILLS_PATH="$HOME/.gemini/skills"

For tools with API integration

集成API的工具配置

export OPENAI_API_KEY="your-key-here" export ANTHROPIC_API_KEY="your-key-here"

Project-specific

项目专属配置

export PROJECT_ROOT="/path/to/project" export DOCS_OUTPUT_DIR="./docs"

undefined

export PROJECT_ROOT="/path/to/project" export DOCS_OUTPUT_DIR="./docs"

undefined

Tool-Specific Configuration

工具专属配置

Cursor (

.cursor/config.json

json

{
  "skills_path": ".cursor/rules",
  "auto_load": true
}

Aider (

.aider.conf.yml

yaml

conventions: CONVENTIONS.md
auto_commits: true

Windsurf (

.windsurf/config.yml

yaml

skills_dir: .windsurf/skills
auto_activate: true

Cursor（

.cursor/config.json

）：

json

{
  "skills_path": ".cursor/rules",
  "auto_load": true
}

Aider（

.aider.conf.yml

）：

yaml

conventions: CONVENTIONS.md
auto_commits: true

Windsurf（

.windsurf/config.yml

）：

yaml

skills_dir: .windsurf/skills
auto_activate: true

Advanced Usage

进阶用法

Creating Skill Bundles

创建技能包

bash

undefined

bash

undefined

Create a custom bundle

创建自定义技能包

mkdir -p my-bundle/skills cp -r engineering-team/senior-architect my-bundle/skills/ cp -r product-team/product-manager my-bundle/skills/ cp -r marketing-skill/content-pod/* my-bundle/skills/

Install bundle

安装技能包

cp -r my-bundle/skills/* ~/.claude/skills/

undefined

cp -r my-bundle/skills/* ~/.claude/skills/

undefined

Automating Skill Updates

自动更新技能

bash

#!/bin/bash

bash

#!/bin/bash

scripts/update-skills.sh

cd ~/claude-skills git pull origin main ./scripts/convert.sh --tool all ./scripts/install.sh --tool cursor --target ~/my-project --force echo "Skills updated!"

undefined

cd ~/claude-skills git pull origin main ./scripts/convert.sh --tool all ./scripts/install.sh --tool cursor --target ~/my-project --force echo "Skills updated!"

undefined

Using Skills in CI/CD

在CI/CD中使用技能

yaml

undefined

yaml

undefined

.github/workflows/skill-audit.yml

name: Security Audit on: [push] jobs: audit: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Audit skills run: | git clone https://github.com/alirezarezvani/claude-skills.git python claude-skills/engineering/skill-security-auditor/scripts/audit.py .

undefined

undefined

Reference Links

参考链接

Repository: https://github.com/alirezarezvani/claude-skills
Documentation: README.md in repo root
Orchestration Guide:
```
orchestration/ORCHESTRATION.md
```
Persona Template:
```
agents/personas/TEMPLATE.md
```
Author: https://alirezarezvani.medium.com/

仓库地址： https://github.com/alirezarezvani/claude-skills
文档： 仓库根目录的README.md
编排指南：
```
orchestration/ORCHESTRATION.md
```
角色模板：
```
agents/personas/TEMPLATE.md
```
作者： https://alirezarezvani.medium.com/

Quick Reference

快速参考

Command	Description
`./scripts/convert.sh --tool all`	Convert all skills to all tools
`./scripts/install.sh --tool cursor --target .`	Install converted skills
`/plugin install <skill>@claude-code-skills`	Install single skill (Claude Code)
`./scripts/gemini-install.sh`	Install for Gemini CLI
`python scripts/sync-hermes-skills.py`	Sync to Hermes Agent
`find .cursor/rules -name "*.mdc"`	Verify Cursor installation

MIT License — 15,045 stars — 268 production-ready skills — 373 Python tools — 12 AI coding tools supported

命令	描述
`./scripts/convert.sh --tool all`	将所有技能转换为所有工具格式
`./scripts/install.sh --tool cursor --target .`	安装转换后的技能
`/plugin install <skill>@claude-code-skills`	安装单个技能（Claude Code）
`./scripts/gemini-install.sh`	安装到Gemini CLI
`python scripts/sync-hermes-skills.py`	同步到Hermes Agent
`find .cursor/rules -name "*.mdc"`	验证Cursor安装结果

MIT License — 15,045颗星 — 268个生产级技能 — 373个Python工具 — 支持12种AI编码工具