awesome-claude-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Awesome Claude Skills

精选Claude Skills合集

Skill by ara.so — Claude Code Skills collection.

This skill provides comprehensive knowledge of the Claude Skills ecosystem, including official and community skills, creation guidelines, installation methods, and best practices for customizing Claude AI workflows.

由ara.so提供的Skill —— Claude Code Skills集合。

本Skill提供了关于Claude Skills生态系统的全面知识，包括官方和社区Skill、创建指南、安装方法，以及定制Claude AI工作流的最佳实践。

What Are Claude Skills?

什么是Claude Skills？

Claude Skills teach Claude how to perform tasks in a repeatable way. They are specialized folders containing instructions, scripts, and resources that Claude dynamically discovers and loads when relevant to tasks.

Claude Skills教会Claude如何以可重复的方式执行任务。它们是包含指令、脚本和资源的专用文件夹，当与任务相关时，Claude会动态发现并加载这些内容。

Progressive Disclosure Architecture

渐进式披露架构

Skills use efficient loading:

Metadata loading (~100 tokens): Claude scans available Skills to identify relevant matches
Full instructions (<5k tokens): Load when Claude determines the Skill applies
Bundled resources: Files and executable code load only as needed

Skills采用高效加载机制：

元数据加载（约100 tokens）：Claude扫描可用的Skills以识别相关匹配项
完整指令加载（<5k tokens）：当Claude确定该Skill适用时加载
捆绑资源加载：仅在需要时加载文件和可执行代码

Installation Methods

安装方法

Claude.ai Web Interface

Claude.ai网页端

Navigate to Settings > Capabilities
Enable Skills toggle
Browse available skills or upload custom skills
For Team/Enterprise: Admin must enable Skills organization-wide first

导航至设置 > 功能
启用Skills开关
浏览可用Skill或上传自定义Skill
团队/企业版：管理员必须先在组织范围内启用Skills

Claude Code CLI

bash

undefined

bash

undefined

Install skills from marketplace

从市场安装skill

/plugin marketplace add anthropics/skills

Install from local directory

从本地目录安装

/plugin add /path/to/skill-directory

Install community skill collections

安装社区Skill集合

/plugin marketplace add obra/superpowers-marketplace

undefined

/plugin marketplace add obra/superpowers-marketplace

undefined

Claude API

python

import anthropic
import os

client = anthropic.Client(api_key=os.environ.get("ANTHROPIC_API_KEY"))

python

import anthropic
import os

client = anthropic.Client(api_key=os.environ.get("ANTHROPIC_API_KEY"))

List available skills

列出可用Skill

response = client.skills.list()

Use skills in conversation

在对话中使用Skill

message = client.messages.create( model="claude-3-5-sonnet-20241022", max_tokens=1024, messages=[ {"role": "user", "content": "Create a Word document with quarterly report"} ], skills=["docx"] )

undefined

message = client.messages.create( model="claude-3-5-sonnet-20241022", max_tokens=1024, messages=[ {"role": "user", "content": "Create a Word document with quarterly report"} ], skills=["docx"] )

undefined

Skill Structure

Skill结构

Basic Skill Format

基础Skill格式

my-skill/
├── SKILL.md          # Main skill file with frontmatter
├── scripts/          # Optional executable scripts
│   └── helper.py
└── resources/        # Optional supporting files
    └── template.json

my-skill/
├── SKILL.md          # 包含前置元数据的主Skill文件
├── scripts/          # 可选的可执行脚本
│   └── helper.py
└── resources/        # 可选的支持文件
    └── template.json

SKILL.md Template

SKILL.md模板

yaml

---
name: my-custom-skill
description: Brief description for skill discovery (keep concise)
triggers:
  - "phrase users might say"
  - "another trigger phrase"
---

yaml

---
name: my-custom-skill
description: 用于Skill发现的简短描述（保持简洁）
triggers:
  - "用户可能说的短语"
  - "另一个触发短语"
---

Detailed Instructions

详细说明

Claude will read these instructions when the skill is activated.

当Skill被激活时，Claude会读取这些说明。

Usage

使用方法

Explain how to use this skill...

解释如何使用此Skill...

Examples

示例

Provide clear examples...

undefined

提供清晰的示例...

undefined

Creating Skills

创建Skill

Using skill-creator (Recommended)

使用skill-creator（推荐）

undefined

undefined

In Claude Code or Claude.ai

在Claude Code或Claude.ai中

User: "Use the skill-creator to help me build a skill for [your task]"

用户："使用skill-creator帮我构建一个用于[你的任务]的Skill"

Follow interactive prompts to generate skill structure

按照交互式提示生成Skill结构

undefined

undefined

Manual Creation Example

手动创建示例

yaml

---
name: api-documentation-generator
description: Generate comprehensive API documentation from code
triggers:
  - "generate API docs"
  - "document my API endpoints"
  - "create API reference"
---

yaml

---
name: api-documentation-generator
description: 从代码生成全面的API文档
triggers:
  - "生成API文档"
  - "记录我的API端点"
  - "创建API参考"
---

API Documentation Generator

API文档生成器

This skill helps create comprehensive API documentation from code.

此Skill帮助从代码创建全面的API文档。

Usage

使用方法

Provide the API code or endpoint definitions
Specify the documentation format (OpenAPI, Markdown, etc.)
Claude generates structured documentation

提供API代码或端点定义
指定文档格式（OpenAPI、Markdown等）
Claude生成结构化文档

Example

示例

For a Flask API:

python

from flask import Flask, jsonify, request

app = Flask(__name__)

@app.route('/api/users', methods=['GET'])
def get_users():
    """Retrieve all users"""
    return jsonify({"users": []})

@app.route('/api/users/<int:user_id>', methods=['GET'])
def get_user(user_id):
    """Retrieve a specific user by ID"""
    return jsonify({"user_id": user_id})

Generated documentation includes:

Endpoint descriptions
HTTP methods
Parameters
Response formats
Example requests/responses

undefined

对于Flask API：

python

from flask import Flask, jsonify, request

app = Flask(__name__)

@app.route('/api/users', methods=['GET'])
def get_users():
    """获取所有用户"""
    return jsonify({"users": []})

@app.route('/api/users/<int:user_id>', methods=['GET'])
def get_user(user_id):
    """通过ID获取特定用户"""
    return jsonify({"user_id": user_id})

生成的文档包括：

端点描述
HTTP方法
参数
响应格式
请求/响应示例

undefined

Key Official Skills

关键官方Skill

Document Manipulation

文档处理

python

undefined

python

undefined

docx skill - Word document handling

docx skill - Word文档处理

Example usage through Claude

通过Claude使用示例

"Create a Word document with the following sections: Introduction, Methods, Results"

"创建包含以下章节的Word文档：引言、方法、结果"

pdf skill - PDF operations

pdf skill - PDF操作

"Extract tables from this PDF and convert to Excel format"

"从该PDF中提取表格并转换为Excel格式"

xlsx skill - Excel spreadsheet handling

xlsx skill - Excel电子表格处理

"Create a spreadsheet with sales data and generate pivot tables"

"创建包含销售数据的电子表格并生成数据透视表"

pptx skill - PowerPoint presentations

pptx skill - PowerPoint演示文稿

"Create a 10-slide presentation about quarterly results with charts"

undefined

"创建一个包含图表的季度结果10页演示文稿"

undefined

Development Skills

开发类Skill

python

undefined

python

undefined

frontend-design skill

"Create a landing page with bold design choices, avoid generic AI aesthetics"

"创建一个具有大胆设计风格的登陆页面，避免通用AI美学"

web-artifacts-builder skill

"Build an interactive dashboard using React, Tailwind, and shadcn/ui"

"使用React、Tailwind和shadcn/ui构建交互式仪表板"

mcp-builder skill

"Create an MCP server that integrates with the GitHub API"

"创建一个集成GitHub API的MCP服务器"

webapp-testing skill

"Test my local webapp at http://localhost:3000 using Playwright"

undefined

"使用Playwright测试我本地的http://localhost:3000网页应用"

undefined

Creative Skills

创意类Skill

python

undefined

python

undefined

algorithmic-art skill

"Create generative art using p5.js with flow fields and particle systems"

"使用p5.js结合流场和粒子系统生成生成式艺术"

canvas-design skill

"Design a poster for a tech conference in PNG format"

"为科技会议设计PNG格式的海报"

slack-gif-creator skill

"Create an animated GIF for Slack showing a progress bar animation"

undefined

"为Slack创建一个显示进度条动画的GIF"

undefined

Community Skills

社区Skill

Installing Superpowers Collection

安装Superpowers集合

bash

undefined

bash

undefined

Install the comprehensive skills library

安装全面的Skill库

/plugin marketplace add obra/superpowers-marketplace

Available commands after installation

安装后可用的命令

/brainstorm # Interactive brainstorming /write-plan # Create detailed plans /execute-plan # Execute planned tasks /skills-search # Search available skills

undefined

/brainstorm # 交互式头脑风暴 /write-plan # 创建详细计划 /execute-plan # 执行计划任务 /skills-search # 搜索可用Skill

undefined

Popular Community Skills

iOS Simulator automation

iOS模拟器自动化

/plugin add https://github.com/conorluddy/ios-simulator-skill

Web fuzzing with ffuf

使用ffuf进行Web模糊测试

/plugin add https://github.com/jthack/ffuf_claude_skill

Browser automation with Playwright

使用Playwright进行浏览器自动化

/plugin add https://github.com/lackeyjb/playwright-skill

D3.js visualizations

D3.js可视化

/plugin add https://github.com/chrisvoncsefalvay/claude-d3js-skill

Scientific computing

科学计算

/plugin add https://github.com/K-Dense-AI/claude-scientific-skills

Security auditing

安全审计

/plugin add https://github.com/trailofbits/skills

Expo app development

Expo应用开发

/plugin add https://github.com/expo/skills

undefined

/plugin add https://github.com/expo/skills

undefined

Best Practices

最佳实践

Skill Design

Skill设计

Keep descriptions concise - Frontmatter description used for discovery
Use clear triggers - Natural phrases users would say
Provide working examples - Show real code, not placeholders
Document dependencies - List required packages/tools
Version with git tags - Use semantic versioning

保持描述简洁 - 前置元数据中的描述用于发现
使用清晰的触发词 - 用户会说的自然短语
提供可运行的示例 - 展示真实代码，而非占位符
记录依赖项 - 列出所需的包/工具
使用Git标签进行版本控制 - 使用语义化版本

Security Considerations

安全注意事项

yaml

undefined

yaml

undefined

✅ Good - Use environment variables

✅ 良好实践 - 使用环境变量

api_key: ${API_KEY} database_url: ${DATABASE_URL}

❌ Bad - Never hardcode secrets

❌ 不良实践 - 切勿硬编码密钥

api_key: "sk-1234567890abcdef"

undefined

api_key: "sk-1234567890abcdef"

undefined

Testing Skills

测试Skill

bash

undefined

bash

undefined

Test locally before sharing

分享前先在本地测试

/plugin add /path/to/my-skill

Verify activation

验证激活情况

"Use my-skill to [trigger phrase]"

"使用my-skill来[触发短语]"

Check skill loading

检查Skill加载情况

Skills should load metadata first, then full instructions when relevant

Skill应先加载元数据，在相关时再加载完整指令

undefined

undefined

Configuration

配置

Skills in Claude Desktop

Claude桌面端中的Skills

Add to

claude_desktop_config.json

json

{
  "skills": {
    "enabled": true,
    "paths": [
      "/path/to/custom/skills",
      "~/.claude/skills"
    ]
  }
}

添加到

claude_desktop_config.json

：

json

{
  "skills": {
    "enabled": true,
    "paths": [
      "/path/to/custom/skills",
      "~/.claude/skills"
    ]
  }
}

Skills in Projects

项目中的Skills

Add to

.claude/config.json

json

{
  "skills": [
    "frontend-design",
    "webapp-testing",
    "custom-skill"
  ],
  "skill_paths": [
    "./skills"
  ]
}

添加到

.claude/config.json

：

json

{
  "skills": [
    "frontend-design",
    "webapp-testing",
    "custom-skill"
  ],
  "skill_paths": [
    "./skills"
  ]
}

Common Patterns

常见模式

Conditional Skill Activation

条件式Skill激活

yaml

---
name: python-testing-skill
description: Generate Python tests with pytest
triggers:
  - "write tests for"
  - "create pytest tests"
---

yaml

---
name: python-testing-skill
description: 使用pytest生成Python测试用例
triggers:
  - "为...编写测试"
  - "创建pytest测试用例"
---

Detect when to activate

检测激活时机

This skill activates when:

Python files are present
User requests test creation
pytest is mentioned or available

undefined

当满足以下条件时激活此Skill：

存在Python文件
用户请求创建测试用例
提到或可用pytest

undefined

Multi-File Skills

多文件Skill

complex-skill/
├── SKILL.md
├── scripts/
│   ├── analyzer.py
│   ├── generator.py
│   └── validator.py
└── resources/
    ├── templates/
    │   ├── template1.json
    │   └── template2.json
    └── config.yaml

Reference in SKILL.md:

markdown

undefined

complex-skill/
├── SKILL.md
├── scripts/
│   ├── analyzer.py
│   ├── generator.py
│   └── validator.py
└── resources/
    ├── templates/
    │   ├── template1.json
    │   └── template2.json
    └── config.yaml

在SKILL.md中引用：

markdown

undefined

Available Scripts

可用脚本

```
scripts/analyzer.py
```
- Analyzes input data
```
scripts/generator.py
```
- Generates output
```
scripts/validator.py
```
- Validates results

```
scripts/analyzer.py
```
- 分析输入数据
```
scripts/generator.py
```
- 生成输出内容
```
scripts/validator.py
```
- 验证结果

Templates

模板

Located in

resources/templates/

```
template1.json
```
- For API responses
```
template2.json
```
- For configuration files

undefined

位于

resources/templates/

：

```
template1.json
```
- 用于API响应
```
template2.json
```
- 用于配置文件

undefined

Troubleshooting

故障排除

Skill Not Activating

Skill未激活

bash

undefined

bash

undefined

Check if skill is loaded

检查Skill是否已加载

In Claude Code:

在Claude Code中：

/plugin list

Verify skill metadata is correct

验证Skill元数据是否正确

Check SKILL.md frontmatter syntax

检查SKILL.md前置元数据语法

Ensure triggers match user intent

确保触发词匹配用户意图

Add more natural trigger phrases

添加更多自然触发短语

undefined

undefined

Skill Conflicts

Skill冲突

yaml

undefined

yaml

undefined

If multiple skills trigger, be specific

如果多个Skill触发，需更具体

Use unique, descriptive names

使用独特且描述性的名称

name: project-specific-testing # ✅ Good name: testing # ❌ Too generic

undefined

name: project-specific-testing # ✅ 良好 name: testing # ❌ 过于通用

undefined

Performance Issues

性能问题

markdown

undefined

markdown

undefined

Keep metadata small (<100 tokens in frontmatter)

保持元数据精简（前置元数据<100 tokens）

Progressive disclosure: Don't load everything at once

渐进式披露：不要一次性加载所有内容

Split large skills into focused sub-skills

将大型Skill拆分为专注的子Skill

undefined

undefined

Resources

资源

Repository: https://github.com/travisvn/awesome-claude-skills
Official Skills: https://github.com/anthropics/skills
API Documentation: https://platform.claude.com/docs/en/api/beta/skills
Community Collections:
- https://github.com/obra/superpowers
- https://github.com/obra/superpowers-skills
Skill Creator Tool: Built-in
```
skill-creator
```
skill
Conversion Tool: https://github.com/yusufkaraaslan/Skill_Seekers

仓库：https://github.com/travisvn/awesome-claude-skills
官方Skill：https://github.com/anthropics/skills
API文档：https://platform.claude.com/docs/en/api/beta/skills
社区集合：
- https://github.com/obra/superpowers
- https://github.com/obra/superpowers-skills
Skill创建工具：内置的
```
skill-creator
```
Skill
转换工具：https://github.com/yusufkaraaslan/Skill_Seekers