心得與介紹

AI agent SKILL - Find Skills

By BrianHsu

安裝 Find Skills

Find Skills 來自 vercel-labs 的 skills repository：

git clone https://github.com/vercel-labs/skills.git

Find Skills 的 Skill 位置：

skills/find-skills/SKILL.md

也可以直接查看：

https://github.com/vercel-labs/skills/blob/main/skills/find-skills/SKILL.md

如何使用

當 Agent 已經支援 Skills 後，可以直接讓 Agent 呼叫：

find-skills

或是在 Prompt 中描述需求：

我想找 docker troubleshooting skill

Find Skills 會協助搜尋適合的 Skill。

用途比較像：

AI Agent 的 Skill Discovery Tool。

問題現象

開始做 AI Agent 後，很容易遇到一個問題：

不知道 SKILL.md 該怎麼寫。

尤其當 Agent 功能開始變多時，常見狀況會變成：

  • 不知道 Skill 要怎麼拆
  • 不知道 Skill 命名方式
  • 不知道別人怎麼設計 Tool Usage
  • 不知道 Prompt 結構該怎麼安排
  • 每次都從零開始寫

最後會變成：

  • Skill 文件越來越亂
  • Prompt 重複貼上
  • Agent 行為不可控
  • 維護成本持續上升

根本原因

大部分人在做 AI Agent 時，都先從 Prompt 開始。

但真正影響 Agent 可維護性的，其實是：

  • Skill 結構
  • 能力切分
  • 任務邊界
  • Tool 使用規則

SKILL.md 本質上比較像：

  • 可重用能力模組
  • Agent 行為契約
  • Prompt Engineering 規格書

問題是：

很多人根本不知道業界怎麼寫。

Find Skills 是專門給 AI Agent 使用的 SKILL 搜尋工具

可以快速查看：

  • 別人怎麼設計 Skill
  • 常見 Skill 結構
  • Tool 使用方式
  • Prompt 組織方式
  • Agent 任務拆分方式

這種工具最大的用途不是直接複製。

而是：

建立 Skill 設計感。

Find Skills 可以解決什麼

1. 降低 Skill 起手門檻

剛開始最痛苦的是：

完全不知道怎麼下筆。

Find Skills 可以直接參考現成結構，例如：

# Skill: Generate Release Notes

## Purpose

Generate release notes from git commits.

## Inputs

- git log
- version number

## Output

- markdown release note

至少會知道：

Skill 文件通常包含哪些區塊。

2. 建立 Skill 拆分概念

很多人一開始會把所有事情塞進一個 Skill。

最後變成：

do_everything_skill.md

這種通常很快失控。

Find Skills 可以觀察別人如何：

  • 拆能力
  • 分責任
  • 控制上下文
  • 限制 Tool 權限

3. 學習 Agent Tool 使用規則

很多 Skill 的重點其實不是 Prompt。

而是：

Tool 如何被限制。

例如：

## Tool Rules

- Only call browser tool when URL is provided
- Never execute shell command without confirmation
- Retry API call at most 2 times

這類規則才是真正影響 Agent 穩定性的核心。

4. 避免 Prompt 污染

Skill 如果沒有邊界，很容易互相污染。

最後會出現：

  • Agent 忘記角色
  • Tool 誤用
  • 任務跳脫
  • Context 爆炸

好的 Skill 設計會刻意：

  • 限縮責任
  • 固定輸入輸出
  • 限制上下文範圍

Find Skills 可以很快看到這些模式。

驗證方式

當 Skill 開始能穩定做到以下幾件事時，代表方向正確：

  • 不同 Agent 可以重用
  • Tool 行為穩定
  • Prompt 不再無限增長
  • 任務責任清楚
  • Context 可控制
  • 容易除錯

這時候 Skill 才真的開始有模組化價值。