AI创业内参
Agent工坊

【Agent工坊】SKILL.md 实战：写一份指令，让 Claude Code / Cursor / Codex 等 16+ AI 工具自动干活

AI创业内参

【Agent工坊】SKILL.md 实战：写一份指令，让 Claude Code / Cursor / Codex 等 16+ AI 工具自动干活

Anthropic 2025年12月发布的 Agent Skills 开放标准，如今已被 16+ 工具支持。写一次指令，跨工具通用——这就是 AI 时代的「npm for agents」。


什么是 Agent Skills？为什么你应该关心

2025年12月18日，Anthropic 发布了一个不起眼但影响深远的东西：Agent Skills 开放标准。它的核心概念极其简单——把给 AI 助手的指令打包成一个可移植的目录，让任何兼容的 AI 工具都能加载执行。


官方定义只有一句话：「A simple, open format for giving agents new capabilities and expertise.」


但对 AI 创业者来说，这意味着一件事：你花时间打磨的提示词和工作流，不再被某个工具锁定。 写一次，Claude Code、Cursor、OpenAI Codex、Gemini CLI、GitHub Copilot、VS Code 等 16+ 工具通用。


截止 2026年5月，支持 Agent Skills 标准的工具矩阵：


工具类型开发者
Claude CodeCLI 编程 AgentAnthropic
CursorAI 编辑器Anysphere
OpenAI CodexCLI 编程 AgentOpenAI
Gemini CLICLI 编程 AgentGoogle
JunieIDE AgentJetBrains
GitHub CopilotAI 编程助手GitHub
VS Code编辑器Microsoft
OpenClaw通用 AgentOpenClaw
OpenHands自主 Agent开源
OpenCodeCLI 编程 Agent开源

跨工具兼容性已有实测数据：agensi.io 团队测试了 10个技能在6个Agent上的表现，8个完全兼容无需修改。仅2个使用Agent专属特性的技能（subagent 并行和 allowed-tools 权限）在部分工具上降级为顺序执行，但不影响输出质量。


SKILL.md 目录结构：比你想的更简单

一个完整的 Agent Skill 只需要一个目录：


my-skill/
├── SKILL.md           # 必需 — 技能定义文件
├── scripts/           # 可选 — 可执行脚本
├── references/        # 可选 — 文档、示例
└── assets/            # 可选 — 图片、模板、配置


仅 SKILL.md 一个文件即可运行。 下面是完整的规范格式：


<hr>
name: code-review
description: "执行全面代码审查，聚焦安全漏洞、性能问题和编码规范。输出带严重等级的结
构化反馈。当用户要求 review、PR审查或安全审计时激活。"
license: MIT
compatibility:

  - claude-code
  - cursor
  - codex
metadata:
  author: your-team
  version: 1.0.0
  tags:

    - code-quality
    - security
    - review
<hr>
# Code Review Skill

## 激活条件
当用户提出以下需求时自动激活此技能：

- "review 这段代码"
- "帮我做 PR review"
- "检查安全问题"

## 审查流程
### 第一步：理解上下文
先阅读相关文件，理解代码的功能目标和修改范围。

### 第二步：安全检查
逐项检查 OWASP Top 10、SQL注入、XSS、认证缺陷、敏感信息泄露。

### 第三步：性能审查
检查算法复杂度、不必要的循环、数据库查询优化、缓存策略。

### 第四步：代码规范
按团队规范检查命名、注释、类型定义、错误处理。

## 输出格式
按严重等级（🔴紧急 🟠高 🟡中 🟢低）分类，每项附带具体文件和行号。


核心设计原则：渐进式披露

这是 Agent Skills 最巧妙的设计。Agent启动时只读取所有技能的 name 和 description 字段，完整内容仅在技能被触发时才加载。


这意味着：即使你装了 50 个技能，每次对话的上下文开销也只有几百字节的元数据。跟把所有指令塞进 Custom Instructions（每条对话都消耗 token）完全不同。


写作技巧：description 字段是最重要的。不要写"帮助代码审查"这种模糊描述，要明确写出触发条件（"当用户要求 review、PR审查或安全审计时"）和输出格式（"带严重等级的结构化反馈"）。


五个配置层的正确分工

Agensi.io 的指南总结了 2026 年 AI Agent 的五个配置层，搞清楚各自分工才能不踩坑：


配置层用途激活方式最适合
Custom Instructions基线偏好始终活跃编码风格、命名规范
AGENTS.md项目上下文仓库内始终可用架构文档、目录结构
SKILL.md按需专业技能触发时加载特定工作流、可复用流程
MCP Server外部工具访问配置后可用数据库、API、云服务
.cursorrules编辑器特定Cursor内仅Cursor团队使用

常见错误：把 5000 字全部塞进 Custom Instructions——每次对话都浪费上下文。正确做法是：Custom Instructions 只保留基线偏好，具体工作流拆分为 SKILL.md 技能。


实战：创建你的第一个技能（5分钟）

这里以一个实用的 commit-writer 技能为例，自动生成规范化的 Git 提交信息。


第一步：创建目录

mkdir -p ~/.claude/skills/commit-writer


对于不同工具，路径约定如下：


Agent个人技能项目技能
Claude Code~/.claude/skills/.claude/skills/
Codex CLI~/.codex/skills/.codex/skills/
Gemini CLI~/.gemini/skills/.gemini/skills/
Cursor—.cursor/skills/
OpenClaw~/.openclaw/skills/.openclaw/skills/

第二步：编写 SKILL.md

<hr>
name: commit-writer
description: "从暂存区变更生成规范的 Conventional Commit 信息。当用户说'commit'、'
提交'、'写commit message'时激活。自动执行 git diff --staged 并生成符合规范的提交信息
。"
license: MIT
compatibility:

  - claude-code
  - cursor
  - codex
  - openclaw
  - gemini-cli
metadata:
  author: ai-neican
  version: 1.0.0
  tags:

    - git
    - workflow
<hr>
# Commit Writer Skill

## 激活条件
当用户提到 commit、提交代码、写 commit message 时激活。

## 工作流程

### 1. 获取暂存区变更
bash git diff --staged --stat git diff --staged 
### 2. 生成 Conventional Commit
类型：feat / fix / docs / style / refactor / perf / test / chore
格式：`type(scope): description`

### 3. Body格式

- 描述修改了什么（What）
- 说明为什么这样改（Why）
- 标注破坏性变更（BREAKING CHANGE）

### 4. 用户确认
展示生成的 commit message，等待用户确认后执行 `git commit -m "..."`。


第三步：测试

在任意支持 Agent Skills 的工具中打开终端，暂存一些修改后说一句「commit」，技能就会自动激活。实测数据表明，这个 SKILL.md 格式在全部 6 个主流 Agent（Claude Code、Codex CLI、Gemini CLI、Cursor、Copilot、OpenClaw）上 100% 兼容通过。


一人开发者的五个必备技能

Agensi.io 创始人总结了 solo developer 最需要的五个技能清单：


1. 代码审查（code-reviewer） —— 没有同事帮你 review，bug 直接上生产。这个技能检查安全漏洞、逻辑错误和边界情况，是单体收益最高的技能。


2. 测试生成（test-generator） —— 知道应该写测试，但没时间。测试技能自动匹配框架和风格，覆盖 happy path、边界条件和错误状态。每次 commit 前跑一次。


3. 文档生成（readme-generator） —— README 永远是过时的。文档技能从实际代码生成和更新文档，保持准确性。


4. DevOps 助手（env-doctor） —— Dockerfile 优化、CI/CD 配置、环境诊断。这些任务不常出现但每次出现就吃掉数小时。


5. 安全审计（security-auditor） —— 没有安全团队。安全检查 OWASP Top 10、依赖漏洞、认证问题。


全部五个技能在 Agensi.io 上有免费版本可以直接下载使用。


变现路径：把技能变成产品

Agensi.io 是一个 AI Agent Skill 交易市场，目前已有 150+ 技能上架。你可以：


  1. 免费发布 → 积累用户和口碑
  2. 一次性购买 → 定价 $5-$99，用户下载即用
  3. 打包销售 → 五个技能的 "solo developer pack" 打包价更高

热门技能类型：代码审查、内容创作、SEO、DevOps、测试、API 开发、安全审计、项目管理。这些都是创业者和 freelance developer 的日常高频需求。


一个技能的开发成本是多少？一个专注的下午——写好 SKILL.md、测试两三个 Agent、打磨 description 让触发准确。一次写完，永久销售。这就是 AI 时代的数字产品。


Claude Code 的内置技能（开箱即用）

Claude Code 预装了三个高级技能，展示了 Skills 标准能做什么：


  • /simplify：派生 3 个并行审查 Agent（可读性、性能、正确性），同时审查代码
  • /batch：派生 5-30 个 worktree Agent，适合大规模重构
  • /debug：交互式调试流程，含堆栈跟踪分析

这些内置技能验证了一个关键事实：Skills 不只是静态指令集，它可以编排多 Agent 协作。


总结：你该立刻做的三件事

  1. 今天就写第一个 SKILL.md。从你最重复的工作流开始——commit message 格式化、代码审查清单、项目部署流程。5 分钟写好，立即可用。
  1. 把 Custom Instructions 里的长文拆成 Skills。你的 Claude Code 或 Cursor 配置里那 3000 字大概率 90% 在大多数对话中都用不上。拆成独立技能，按需加载。
  1. 去 Agensi.io 逛逛。下载 2-3 个免费技能体验效果，看看别人怎么写 SKILL.md。如果你有打磨成熟的技能，考虑上架变现。

一个 SKILL.md 文件，16+ 工具通用，写了就不会浪费。这就是 2026 年 AI 创业者的基本工作流资产。

#AI创业 #AgentSkills #SKILLmd #一人公司 #ClaudeCode #Cursor


本文由AI辅助创作，经人工审核编辑发布