什么是技能？

技能是人工智能代理可重用的功能。它们提供程序性知识，帮助代理更高效地完成特定任务。你可以把它们想象成插件或扩展程序，增强人工智能代理的功能。

入门

要安装技能，请使用CLI： skills

npx skills add vercel-labs/agent-skills

这将安装该技能并使其可供您的 AI 代理使用。

技能排名

技能排行榜根据从命令行界面(CLI) 收集的匿名遥测数据对技能进行排名。当用户安装技能时，汇总的使用数据有助于发现生态系统中最受欢迎和最有用的技能。 skills

这种遥测技术完全匿名，仅跟踪正在安装的技能——不会收集任何个人信息或使用模式。

Agent Skills 是一种轻量级、开源的格式，用于为 Agent 扩展专业知识与工作流能力。

Skills 的核心是一个文件夹，其中包含 SKILL.md 文件。该文件至少包含元数据（name 名称、description 描述）以及指导 Agent 执行特定任务的指令。Skills 同时可以打包脚本、模板和参考资料。

my-skill/
├── SKILL.md          # 必需：指令 + 元数据
├── scripts/          # 可选：可执行代码
├── references/       # 可选：文档资料
└── assets/           # 可选：模板、资源文件

Skills 的工作原理

Skills 使用渐进式披露机制高效管理上下文：

1. 发现阶段：Agent 启动时，仅加载所有可用 Skill 的名称与描述，足够判断该 Skill 是否相关即可。
2. 激活阶段：当任务匹配某个 Skill 的描述时，Agent 会将完整的 SKILL.md 指令加载至上下文。
3. 执行阶段：Agent 按照指令执行任务，可按需加载引用文件或运行内置代码。

该方案既能保证 Agent 运行速度，又能按需加载更多上下文信息。

SKILL.md 文件规范

每个 Skill 都以 SKILL.md 文件为入口，文件包含 YAML 头部元数据与 Markdown 指令内容：

---
name: pdf-processing
description: 提取PDF文本、填写表单、合并文件。处理PDF相关任务时使用。
---

# PDF 处理技能

## 使用场景
当用户需要操作 PDF 文件时，使用本 Skill……

## 文本提取步骤
1. 使用 pdfplumber 进行文本提取……

## 表单填写步骤
……

SKILL.md 顶部必须包含以下元数据：

• name：简短唯一标识
• description：该 Skill 的适用场景

Markdown 正文为实际执行指令，对结构和内容无特殊限制。

这种简洁格式具备以下核心优势：

• 自带文档说明：Skill 创作者或用户可直接阅读 SKILL.md 了解功能，易于审核、优化。
• 可扩展：Skill 复杂度灵活，可仅为纯文本指令，也可包含可执行代码、资源、模板。
• 可移植：Skill 以文件形式存在，易于编辑、版本管理与分享。

后续参考

• 阅读创作最佳实践，编写高效 Skill
• 使用参考库校验 Skill、生成提示词 XML

核心特性

• 一站式技能管理：兼容并管理多个主流 AI 编程助手的 Skill 生命周期。
• 丰富的技能商店：聚合 GitHub 优质开源技能库（如 anthropics/skills），探索最新、最强的 AI 技能并实现一键安装。
• SKill 同步：支持设置默认 AI Agent，并能一键将技能灵活分发与同步至其他Agent。

常用 AI Agent

Skill Lake 会自动扫描并管理以下主流助手在本地的扩展目录：

安装

brew tap emlog/skill-lake
brew install --cask skill-lake

更新

brew update
brew upgrade --cask skill-lake

源码编译运行

1.克隆项目源码：

git clone https://github.com/emlog/skill-lake.git
cd skill-lake

2.启用 macOS 桌面开发支持（如果你是首次运行 Flutter 桌面端项目）：

flutter config --enable-macos-desktop

3.获取项目依赖包：

flutter pub get

4.编译并启动应用：

flutter run -d macos

下载安装包

SkillLake-1.1.9-arm64

❓ 常见问题 (FAQ)

⚠️ 运行或安装时提示「“Skill Lake”已损坏，无法打开。您应该将它移到废纸篓。」怎么办？

由于应用暂未进行 Apple 开发者证书的签名与公证，macOS 的 Gatekeeper 机制可能会拦截此应用并给出“已损坏”或“移到废纸篓”的警告提示。

解决方法：

1. 遇到提示时，请先点击弹窗上的 「取消」。
2. 打开 macOS 的 「系统设置」 > 「隐私与安全性」。
3. 向下滚动到“安全性”板块，这里会有一条拦截记录（提示“Skill Lake”已被阻止使用）。
4. 点击旁边的 「仍然打开」（或 「仍然允许」）按钮，并在弹出的安全验证中输入您的 Mac 开机密码或通过触控 ID 授权。
5. 授权完成后，再次尝试打开 Skill Lake，此时弹出的确认框中会出现 「打开」 按钮，点击后系统将记住您的选择，以后就不会再被拦截了。

代码库

https://github.com/emlog/skill-lake

仙人掌 AI 助手（Cactus）是一款专为 macOS 设计的智能文字处理工具。通过集成先进的 AI 技术，提供一键翻译、内容总结、单词查询及截图 OCR 识别等功能，极大提升您的办公与学习效率。基于 MIT 协议完全免费且开源。

核心功能

• 快捷翻译：在任何地方选中文本，按下 ⌥ + X 即可瞬间获取翻译结果。
• 智能总结：快速提炼长篇文章或文档的要点，节省阅读时间。
• 上下文词典：深入解释字词义项、词源，并提供丰富的用法示例。
• 截图 OCR：支持截取屏幕区域进行文字识别，并自动完成翻译。
• 生词本与收藏：轻松保存生词和翻译片段，支持基于遗忘曲线的复习计划。
• 权限引导优化：更友好的辅助功能权限请求界面，支持在未授权时直接打开主窗口。
• 隐私保护：您的数据保留在本地，仅与您配置的 AI 服务商进行交互。

安装说明

Homebrew (推荐)

通过 Homebrew 快速安装：

brew install emlog/cactus

手动安装

1. 从 GitHub Releases 页面下载最新版本。
2. 将 Cactus.app 拖入 Applications（应用程序）文件夹。

使用指南

• 默认快捷键（均可在偏好设置中自定义）：
  • ⌥ + X：翻译选中内容。
  • ⌥ + S：总结选中内容。
  • ⌥ + Z：字典查询。
  • ⌥ + A：截图 OCR 翻译。
  • ⌥ + C：打开主助手窗口。

配置说明

仙人掌 AI 助手支持多种主流 AI 服务商，如 OpenAI、DeepSeek、Claude、Gemini、智谱、火山引擎等。您只需在“偏好设置”中填入对应的 API Key 即可开始使用。

开源协议

本项目采用 MIT 协议开源 - 详情请参阅 LICENSE 文件。

下载安装

Cactus-1.4.3-arm64

⚠️ 常见问题：提示“App 已损坏”或“无法打开”？

如果您在首次运行时看到 “Cactus.app 已损坏，无法打开” 或 “身份不明的开发者” 的提示，这是由于应用未经过苹果官方付费签名导致。

解决方法：

1. 执行终端命令：
   打开 终端 (Terminal.app)，粘贴并运行以下命令（输入密码时不会显示字符）：

   sudo xattr -rd com.apple.quarantine /Applications/Cactus.app

2. 手动允许（如果上述命令执行后仍无法打开）：
   前往 系统设置 -> 隐私与安全性 -> 安全性 模块，点击 “仍要打开”。
3. 现在您可以正常运行 Cactus 了。

代码库

https://github.com/emlog/cactus