介绍 Agent Skills Marketplace 平台及其 SKILL.md 开放标准。该平台汇聚超 36 万开源技能，支持 Claude Code 和 OpenAI Codex。内容涵盖技能发现、安装使用、开发实战及安全实践。开发者可通过定义 SKILL.md 文件创建模块化能力单元，实现 AI 模型自动决策调用。文章提供从环境配置到发布维护的全流程指南，强调权限控制与源码审查，助力提升编程效率。
Agent Skills Marketplace (skillsmp.com) 是一个汇聚了超过 36 万个开源 Agent 技能的社区平台，为 Claude Code、OpenAI Codex CLI 和 ChatGPT 等 AI 编程助手提供统一的技能发现和安装入口。本文深入解析 SKILL.md 开放标准、技能市场架构、开发工作流以及实际应用场景，帮助开发者快速找到并创建高质量的 AI 技能，提升编程效率。
2025 年 12 月，Anthropic 发布了 Agent Skills 规范作为开放标准，随后 OpenAI 也采用相同格式支持 Codex CLI 和 ChatGPT。这一标准化举措彻底改变了 AI 编程助手的能力扩展方式。
传统扩展方式 vs 技能系统
| 特性 | 传统插件 | Agent Skills | | :—: | :— | | 调用方式 | 手动触发 | 模型自动决策 | | 上下文感知 | 弱 | 强 | | 跨平台性 | 差 | 优秀 | | 标准化程度 | 低 | 高 |
技能（Skills）是模块化的能力单元，通过 SKILL.md 文件定义指令、可选脚本和模板。AI 模型会根据上下文自动决定何时使用这些技能，实现更智能的工作流自动化。
Agent Skills Marketplace 是一个独立的社区项目，致力于解决以下核心问题：
SKILL.md 是 Agent Skills 的核心 manifest 文件，采用 YAML Frontmatter + Markdown 内容的结构。
基本要求
| 要求项 | 规范 |
|---|---|
| 文件名 | SKILL.md（区分大小写） |
| 文件夹命名 | kebab-case（无空格、下划线、大写字母） |
| Frontmatter 分隔符 | --- |
| 最大行数 | 500 行（推荐<150 行） |
| name 字段 | ≤64 字符，仅小写字母、数字、连字符 |
| description 字段 | ≤1024 字符 |
---
name: code-reviewer
description: Automatically review code changes and suggest improvements
---
# Code Reviewer Skill
This skill provides automated code review capabilities...
---
name: git-automation
description: Automate common Git workflows and commands
license: MIT
compatibility:
- claude-code
- openai-codex
allowed-tools: exec read write
user-invocable: true
disable-model-invocation: false
argument-hint: "<action>"
server: "https://github.com/example/git-skill"
---
字段说明
| 字段 | 必需 | 说明 |
|---|---|---|
name | ✓ | 技能名称，同时作为斜杠命令 |
description | ✓ | 技能描述，AI 决策依据 |
license | ✗ | 许可证类型 |
compatibility | ✗ | 兼容平台列表 |
allowed-tools | ✗ | 预批准工具列表（空格分隔） |
user-invocable | ✗ | 是否允许用户手动调用 |
disable-model-invocation | ✗ | 是否禁止模型自动调用 |
argument-hint | ✗ | 参数提示 |
server | ✗ | 来源服务器 URL（用于溯源） |
skill-name/
├── SKILL.md # 必需：技能定义文件
├── scripts/ # 可选：脚本文件
│ ├── setup.sh
│ └── run.py
├── templates/ # 可选：模板文件
│ └── component.template
├── examples/ # 可选：示例
│ └── usage.md
└── references/ # 可选：参考资料
└── docs.md
AI 语义搜索
SkillsMP 支持 AI 语义搜索，理解用户的真实需求而非简单的关键词匹配。
搜索示例
# 搜索类型 1：AI 语义搜索
search --ai "帮我找出项目中的安全漏洞"
# 搜索类型 2：关键词搜索
security vulnerability scanner
# 搜索类型 3：组合过滤
category:security sort:popularity
平台按主要用例组织技能分类：
categories/
├── code-review/ # 代码审查
├── testing/ # 测试自动化
├── documentation/ # 文档生成
├── deployment/ # 部署自动化
├── security/ # 安全扫描
├── git-automation/ # Git 工作流
└── data-processing/ # 数据处理
筛选标准
| 指标 | 阈值 | 说明 |
|---|---|---|
| GitHub Stars | ≥2 | 过滤低质量仓库 |
| 最后更新时间 | - | 显示在技能卡片上 |
| 基础质量扫描 | 通过 | 自动扫描基础质量问题 |
| 社区评价 | - | 用户反馈和评分 |
基于技能最后推送时间（非当日提交数）进行趋势分析，帮助用户发现活跃维护的技能。
Claude Code
# 个人技能（全局）
~/.claude/skills/
# 项目技能（局部）
<project>/.claude/skills/
OpenAI Codex CLI
# 个人技能
~/.codex/skills/
# 项目技能
<project>/.codex/skills/
方法 1：手动安装
# 1. 克隆技能仓库
git clone https://github.com/author/skill-name.git
# 2. 复制到技能目录
cp -r skill-name ~/.claude/skills/
# 3. 验证安装
claude skills --list
方法 2：使用技能工具
# 使用技能创建/安装工具
skill-creator install author/skill-name
模型自动调用
AI 会根据上下文自动选择合适的技能：
用户：帮我审查这段代码的安全问题
AI: [自动调用 code-security-reviewer 技能]
手动调用（斜杠命令）
用户：/code-reviewer src/main.py
多技能组合
Claude 支持同时使用多个技能：
用户：审查并提交这些更改
AI: [组合使用 code-reviewer + git-automation 技能]
步骤 1：创建目录结构
mkdir code-reviewer
cd code-reviewer
mkdir scripts templates examples
步骤 2：编写 SKILL.md
---
name: code-reviewer
description: Review code for bugs, security issues, and best practices
license: MIT
compatibility:
- claude-code
- openai-codex
allowed-tools: read exec
user-invocable: true
---
# Code Reviewer
Automated code review skill that analyzes code for:
- Logic errors and bugs
- Security vulnerabilities
- Code style violations
- Performance issues
- Best practice violations
## Usage
Use this skill when:
1. User requests code review
2. Before committing changes
3. After implementing new features
## Process
1. Read the target file(s)
2. Analyze code structure
3. Check for common issues
4. Provide actionable recommendations
## Examples
See examples/ directory for usage examples.
步骤 3：添加分析脚本
#!/usr/bin/env python3
"""代码分析器 - 检查常见问题"""
import ast
import sys
from pathlib import Path
def analyze_file(filepath: str) -> list:
"""分析单个文件，返回问题列表"""
issues = []
try:
with open(filepath, 'r', encoding='utf-8') as f:
code = f.read()
# AST 分析
tree = ast.parse(code)
# 检查项 1: 未使用的导入
imports = [node for node in ast.walk(tree) if isinstance(node, ast.Import)]
# 检查项 2: 复杂函数
functions = [node for node in ast.walk(tree) if isinstance(node, ast.FunctionDef)]
for func in functions:
complexity = calculate_complexity(func)
if complexity > 10:
issues.append(f"函数 '{func.name}' 复杂度过高：{complexity}")
return issues
except Exception as e:
return [f"分析失败：{str(e)}"]
def calculate_complexity(func_node) -> int:
"""计算函数圈复杂度"""
complexity = 1
for node in ast.walk(func_node):
if isinstance(node, (ast.If, ast.While, ast.For, ast.ExceptHandler)):
complexity += 1
return complexity
if __name__ == "__main__":
if len(sys.argv) < 2:
print("用法：python analyzer.py <file>")
sys.exit(1)
issues = analyze_file(sys.argv[1])
for issue in issues:
print(f"⚠️ {issue}")
步骤 4：创建使用示例
## 示例 1：审查单个文件
用户：/code-reviewer src/auth.py
## 示例 2：审查整个目录
用户：帮我审查 src 目录下所有 Python 文件
## 示例 3：提交前审查
用户：在提交前审查这些更改
AI: [自动调用 code-reviewer 技能分析变更文件]
步骤 5：本地验证
# 使用验证脚本
python quick_validate.py
# 或使用 Claude 插件验证
claude plugin validate
步骤 6：发布
# 推送到 GitHub
git init
git add .
git commit -m "Initial release: code-reviewer skill"
git push origin main
# 确保仓库公开且获得至少 2 个 stars
安装前检查清单
危险信号
| 警告信号 | 风险等级 | 说明 |
|---|---|---|
| 要求提供 API 密钥 | 🔴 高危 | 绝不粘贴密钥到聊天 |
| 请求敏感文件访问 | 🟡 中危 | 谨慎评估必要性 |
| 执行未知外部命令 | 🟡 中危 | 审查命令内容 |
| 无许可证声明 | 🟢 低危 | 注意版权风险 |
1. 保持技能专注
每个技能应专注于单一职责，避免功能臃肿。
# 推荐：单一职责
name: code-formatter
description: Format code according to style guides
# 不推荐：多功能
name: all-in-one-tool
description: Format, lint, test, deploy, and monitor code
2. 清晰的描述
描述应明确说明技能的用途和使用时机。
# 好的描述
description: Review Python code for PEP 8 violations and suggest fixes
# 模糊的描述（不推荐）
description: A tool for code
3. 合理的工具权限
仅声明必要的工具权限。
# 只读操作
allowed-tools: read
# 需要执行命令
allowed-tools: read exec
# 需要文件写入
allowed-tools: read write exec
4. 提供充分文档
在 SKILL.md 中包含：
5. 版本控制与更新
| 特性 | Claude Code | OpenAI Codex |
|---|---|---|
| 技能格式 | SKILL.md | SKILL.md（相同标准） |
| 安装路径 | ~/.claude/skills/ | ~/.codex/skills/ |
| 加载机制 | 渐进式披露（启动时加载 Frontmatter） | 隐藏系统提示注入 |
| 分层存储 | 支持（Tier 2/3） | 不支持 |
| 发布方式 | 本地文件系统 | Skills API 上传 Bundle |
| Bundle 限制 | 无 | 有（大小、文件数、单个 SKILL.md） |
| 特性 | Skills | Slash Commands |
|---|---|---|
| 调用方式 | 模型自动决策 | 用户手动触发 |
| 上下文感知 | 强 | 无 |
| 灵活性 | 高 | 低 |
| 适用场景 | 复杂工作流 | 简单固定操作 |
SKILL.md 设计为跨平台标准，但需要注意：
| 主题 | 核心内容 |
|---|---|
| SkillsMP 平台 | 36 万 + 技能，智能搜索，分类浏览，质量筛选 |
| SKILL.md 标准 | 开放格式，跨平台，YAML Frontmatter + Markdown |
| 安装使用 | 复制到技能目录，AI 自动调用或手动触发 |
| 开发流程 | 创建目录 → 编写 SKILL.md → 添加脚本 → 验证 → 发布 |
| 安全实践 | 审查源码，限制权限，不粘贴密钥，定期更新 |
对于使用者
对于开发者
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online