Agent-Skills使用指南

背景

Agent Skills 是当前 AI Agent生态中不可或缺的能力扩展机制，一直不知道怎么使用。

针对以下问题，调研和整理成本文。

1. 检索？
2. 安装？
3. 使用？
4. 自建？
5. 扩展？

步骤

1. 安装环境

• openskills 负责的是索引和跨工具分发（团队同步、工具技能索引同步）
• skill.sh负责下载管理特定skill（当前使用）

npx和npm的区别

npm install -g skills.sh

2. ### 搜索Skill

有两种搜索方式，可根据场景灵活选择：

• 网页搜索：访问 skills.sh 在线浏览和搜索可用技能
• 命令行搜索：根据当前需求，使用关键词或会话上下文搜索

npx skills find <关键词>

3. 使用Skill

• 安装skill

# 安装skills
# npx skills add <owner/repo> 从skills.sh中找到安装命令行

 npx skills add https://github.com/anthropics/skills --skill slack-gif-creator
 
 # 安装时，选择要安装的平台如cursor、Global/Project安装
 # cursor的 skills内，出现了新add的skill
 # 选择“快捷方式”创建的~/.cursor/skills下的链接 skill cursor可能发现不了，最好copy

说明：新的skills，快捷使用方法

使用LLM（如gemini上传skill.md，写一个使用demo的prompt）

• 使用

  • 自动调用
  • 
  • 手动调用

  •   # cursor对话框中，"/"+"skillname" 选中写prompt
    
      /slack-gif-creator 制作一个 128x128 的 Emoji GIF。要求：中心点向外喷发 20 个五彩斑斓的小圆点粒子，每个粒子具有随机的角度和初速度。粒子在运动过程中受重力加速度影响向下坠落，并逐渐透明消失（Fade out）。背景设为深色渐变，粒子描边宽度设为 2 以保持精致感。 
      /slack-gif-creator 创建文字gif，内容为："Bryce Happy New Year"
    

  • 成果展示

• 其它案例

# file-organizer整理项目目录
/file-organizer 整理@outputs 目录
# 没有出现

 # outputs/ 目录分析
# 当前状态：
# 4 个文件
# 2 个 Python 脚本（. py ）：particle_burst. py ( 6. 3K), text_gif. py ( 5. 9K)
# 2 个 GIF 图片（. gif ）：bryce_happy_new_year. gif (547K), particle_burst. gif (23K)
# 总大小：约 582K
# 问题：
# 脚本与输出文件混在一起
# outputs/ 应只存放输出文件，不应包含源代码

outputs/
└── gifs/                    # GIF 输出文件
    ├── bryce_happy_new_year.gif
    └── particle_burst.gif

scripts/                     # Python 脚本
    ├── manage_submodules.sh
    ├── particle_burst.py   # 已更新路径
    ├── text_gif.py         # 已更新路径
    └── update_all.sh

/theme-factory 切换Forest Canopy风格的主题

4. 自建Skill

步骤：

1. cursor辅助创建

2. 更改skill.md文档细节
3. 发布/拷贝

给多个项目使用，如下复制到.cursor/skills下为全局应用

 #!/bin/zsh

# 根据脚本目录，获取skills目录
skills_dir=$(dirname $(dirname $(realpath $0)))/.cursor/skills

echo "skills_dir: $skills_dir"

# 打印当前所有的skills，供选择（格式如下）：
# 1. mece-classifier
# 2. my-skill
# 3. ...
skills=($(ls $skills_dir))
echo "可用的技能列表："
for i in {1..$#skills}; do
    echo "  $i. ${skills[$i]}"
done
echo ""

# 选择技能
select skill in $skills; do
    if [ -n "$skill" ]; then
        break
    fi
done

echo "选择的技能: $skill"

# 目标目录
target_dir=~/.cursor/skills
# 区分本地项目技能（如 mece-classifier[project1]），全局技能名拼接 -global
if [[ "$skill" =~ [.*]$ ]]; then
    base_skill=${skill%%[*}
    target_skill_name="${base_skill}-global"
else
    target_skill_name="${skill}-global"
fi
target_path=$target_dir/$target_skill_name
source_path=$(realpath $skills_dir/$skill)

# 确保目标目录存在
mkdir -p $target_dir

# 方法1：复制到全局技能目录
cp -r $source_path $target_path

echo "skills: ${target_skill_name} 发布/更新成功"

5. 扩展能力

自研Agent，集成Skills

A skills-compatible agent needs to:

1. Discover skills in configured directories
2. Load metadata (name and description) at startup
3. Match user tasks to relevant skills
4. Activate skills by loading full instructions
5. Execute scripts and access resources as needed

• 省钱/省 Context：不用的文档不加载，节省上下文空间。
• 防幻觉：让 AI 专注于当前的指令，减少无关信息的干扰。
• 模块化：你可以让多个不同的 Skills 引用同一个 references 里的规范文件。

外部能力，Composio（连接器～付费的～）

“万能适配器”，AI Agent（智能体）生态中功能最强大的 “技能与连接中心”

skills能力：awesome-claude-skills

参考

Skill管理工具

• Openskills 和skill.sh

npx和npm的区别

Skill使用问题

• Cursor

~/.cursor/skills下的链接 skill 不能发现