awesome-claude-skills

用途

awesome-claude-skills 是一个专注于 Claude Skills 生态的知识型技能（Skill），由 ara.so 维护。它帮助用户了解如何通过 Claude Skills 定制 Claude AI 的工作流与智能体编程（agentic coding）。Claude Skills 用可重复的方式教会 Claude 执行任务，其本质是包含指令、脚本和资源的专用文件夹，Claude 会在任务相关时动态发现并加载它们。

主要能力（知识覆盖范围）

该技能提供关于 Claude Skills 生态的全面知识，包括：

官方与社区技能（official and community skills）
技能创建指南（creation guidelines）
安装方法（installation methods）
定制 Claude AI 工作流的最佳实践（best practices）

渐进式披露架构（Progressive Disclosure Architecture）

技能采用高效加载方式：

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

使用方式

安装方法

Claude.ai 网页界面：

进入 Settings > Capabilities（https://claude.ai/settings/capabilities）
启用 Skills 开关
浏览可用技能或上传自定义技能
对于 Team/Enterprise：需管理员先在全组织范围启用 Skills

Claude Code CLI：

# Install skills from marketplace
/plugin marketplace add anthropics/skills

# Install from local directory
/plugin add /path/to/skill-directory

# Install community skill collections
/plugin marketplace add obra/superpowers-marketplace

Claude API：

import anthropic
import os

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

# List available skills
response = client.skills.list()

# Use skills in conversation
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"]
)

技能结构

基础技能格式：

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

SKILL.md 模板：

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

# Detailed Instructions

Claude will read these instructions when the skill is activated.

## Usage
Explain how to use this skill...

## Examples
Provide clear examples...

创建技能

推荐使用 skill-creator：

# In Claude Code or Claude.ai
User: "Use the skill-creator to help me build a skill for [your task]"

# Follow interactive prompts to generate skill structure

适用场景

技能文档中列举了若干官方与社区技能的使用示例：

文档处理：docx（Word 文档）、pdf（PDF 操作）、xlsx（Excel 表格）、pptx（PowerPoint 演示）
开发技能：frontend-design、web-artifacts-builder、mcp-builder、webapp-testing
创意技能：algorithmic-art（p5.js 生成艺术）、canvas-design、slack-gif-creator

社区技能安装示例（原始命令）：

# iOS Simulator automation
/plugin add https://github.com/conorluddy/ios-simulator-skill

# Web fuzzing with ffuf
/plugin add https://github.com/jthack/ffuf_claude_skill

# Browser automation with Playwright
/plugin add https://github.com/lackeyjb/playwright-skill

# D3.js visualizations
/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
/plugin add https://github.com/expo/skills

Superpowers 合集安装后可用命令：

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

最佳实践与配置

技能设计要点

保持描述简洁——frontmatter 描述用于技能发现
使用清晰的触发器——用户会自然说出的短语
提供可运行示例——展示真实代码而非占位符
记录依赖——列出所需包/工具
用 git 标签做版本管理——使用语义化版本

安全注意事项

# ✅ Good - Use environment variables
api_key: ${API_KEY}
database_url: ${DATABASE_URL}

# ❌ Bad - Never hardcode secrets
api_key: "sk-1234567890abcdef"

测试技能

# Test locally before sharing
/plugin add /path/to/my-skill

# Verify activation
"Use my-skill to [trigger phrase]"

Claude Desktop 配置

加入 claude_desktop_config.json：

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

项目内配置

加入 .claude/config.json：

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

常见模式与故障排查

条件式技能激活：通过描述与触发条件判断何时启用（如存在 Python 文件、用户请求创建测试等）
多文件技能：SKILL.md 搭配 scripts/ 与 resources/ 目录，并在文档中引用各脚本与模板
技能未激活：可用 /plugin list 检查是否加载，核对 SKILL.md frontmatter 语法，增加更自然的触发短语
技能冲突：使用唯一且具描述性的名称（如 project-specific-testing 优于 testing）
性能问题：保持元数据精简（frontmatter 小于 100 tokens），利用渐进式披露按需加载，将大型技能拆分为聚焦的子技能

限制

用户问题中提供的资料未说明该技能的收费、价格、平台限制或具体使用效果，这些信息暂未提供。该内容为知识整理型技能，本身不执行文档处理、编程或设计等具体任务，而是提供关于 Claude Skills 的选择、安装与使用指引。