Back to Details

acquiring-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Acquiring New Skills

获取新Skill

This skill teaches you how to safely discover and install skills from external sources.
本Skill将教你如何从外部源安全地发现并安装Skill。

SAFETY - READ THIS FIRST

安全须知 - 请先阅读这部分

Skills can contain:
  • Markdown files (.md) - Risk: prompt injection, misleading instructions
  • Scripts (Python, TypeScript, Bash) - Risk: malicious code execution
Skill可能包含：
  • Markdown文件（.md）- 风险：提示注入、误导性说明
  • 脚本（Python、TypeScript、Bash）- 风险：恶意代码执行

Trusted Sources (no user approval needed for download)

可信源（下载无需用户批准）

  • https://github.com/letta-ai/skills
    - Letta's community skills
  • https://github.com/anthropics/skills
    - Anthropic's official skills
  • https://github.com/letta-ai/skills
    - Letta社区Skill库
  • https://github.com/anthropics/skills
    - Anthropic官方Skill库

Untrusted Sources (ALWAYS verify with user)

不可信源（必须与用户确认）

For ANY source other than letta-ai or anthropics:
  1. Ask the user before downloading
  2. Explain where the skill comes from
  3. Get explicit approval
对于任何非letta-ai或anthropics的源：
  1. 下载前询问用户
  2. 说明Skill的来源
  3. 获取明确批准

Script Safety

脚本安全

Even for skills from trusted sources, ALWAYS:
  1. Read and inspect any scripts before executing them
  2. Understand what the script does
  3. Be wary of network calls, file operations, or system commands
即使是来自可信源的Skill，也必须：
  1. 执行前阅读并检查所有脚本
  2. 了解脚本的功能
  3. 警惕网络调用、文件操作或系统命令

When to Use This Skill

何时使用本Skill

DO use when:
  • User asks for something where a skill likely exists (e.g., "help me test this webapp", "generate a PDF report")
  • You think "there's probably a skill that would bootstrap my understanding"
  • User explicitly asks about available skills or extending capabilities
DON'T use for:
  • General coding tasks you can already handle
  • Simple bug fixes or feature implementations
  • Tasks where you have sufficient knowledge
建议使用的场景：
  • 用户提出的需求可能存在对应的Skill（例如："帮我测试这个Web应用"、"生成一份PDF报告"）
  • 你认为"可能存在某个Skill可以帮助我快速上手"
  • 用户明确询问可用Skill或如何扩展能力
不建议使用的场景：
  • 你已经能处理的常规编码任务
  • 简单的bug修复或功能实现
  • 你已有足够知识储备的任务

Ask Before Searching (Interactive Mode)

搜索前询问用户（交互模式）

If you recognize a task that might have an associated skill, ask the user first:
"This sounds like something where a community skill might help (e.g., webapp testing with Playwright). Would you like me to look for available skills in the Letta or Anthropic repositories? This might take a minute, or I can start coding right away if you prefer."
The user may prefer to start immediately rather than wait for skill discovery.
Only proceed with skill acquisition if the user agrees.
如果你识别到某个任务可能有对应的Skill，请先询问用户：
"这看起来是一个可以借助社区Skill完成的任务（例如：使用Playwright进行Web应用测试）。你希望我去Letta或Anthropic的仓库中查找可用的Skill吗？这可能需要一点时间，或者你更希望我直接开始编写代码？"
用户可能更倾向于直接开始工作而非等待Skill发现。
只有在用户同意后，再进行Skill获取操作。

Skill Repositories

Skill仓库

RepositoryDescription
https://github.com/letta-ai/skillsCommunity skills for Letta agents
https://github.com/anthropics/skillsAnthropic's official Agent Skills
Browse these repositories to discover available skills. Check the README for skill listings.
仓库地址描述
https://github.com/letta-ai/skillsLetta Agent的社区Skill库
https://github.com/anthropics/skillsAnthropic官方Agent Skill库
浏览这些仓库以发现可用Skill，查看README获取Skill列表。

Installation Locations

安装位置

LocationPathWhen to Use
Agent-scoped
~/.letta/agents/<agent-id>/skills/<skill>/
Skills for a single agent (default for agent-specific capabilities)
Global
~/.letta/skills/<skill>/
General-purpose skills useful across projects
Project
.skills/<skill>/
Project-specific skills
Rule: Default to agent-scoped for changes that should apply only to the current agent. Use project for repo-specific skills. Use global only if all agents should inherit the skill.
位置路径使用场景
Agent专属
~/.letta/agents/<agent-id>/skills/<skill>/
仅用于单个Agent的Skill（Agent专属能力的默认位置）
全局
~/.letta/skills/<skill>/
适用于所有项目的通用Skill
项目专属
.skills/<skill>/
特定项目的Skill
规则：默认使用Agent专属位置存储仅适用于当前Agent的Skill。项目专属Skill存储在项目目录下。仅当所有Agent都需要继承该Skill时，才使用全局位置。

How to Download Skills

如何下载Skill

Skills are directories containing SKILL.md and optionally scripts/, references/, examples/.
Skill是包含SKILL.md文件，以及可选的scripts/、references/、examples/目录的文件夹。

Method: Clone to /tmp, then copy

方法：克隆到/tmp，再复制

bash
undefined
bash
undefined

1. Clone the repo (shallow)

1. 克隆仓库（浅克隆）

git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp

2. Copy the skill to your skills directory

2. 将Skill复制到你的Skill目录

For agent-scoped (recommended default):

For agent-scoped (recommended default):

cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/
cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/

For global:

For global:

cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/skills/

cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/skills/

For project:

For project:

cp -r /tmp/skills-temp/skills/webapp-testing .skills/

cp -r /tmp/skills-temp/skills/webapp-testing .skills/

3. Cleanup

3. Cleanup

rm -rf /tmp/skills-temp
undefined
rm -rf /tmp/skills-temp
undefined

Alternative: rsync (preserves permissions)

Alternative: rsync (preserves permissions)

bash
git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
rsync -av /tmp/skills-temp/skills/webapp-testing/ ~/.letta/agents/<agent-id>/skills/webapp-testing/
rm -rf /tmp/skills-temp
bash
git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
rsync -av /tmp/skills-temp/skills/webapp-testing/ ~/.letta/agents/<agent-id>/skills/webapp-testing/
rm -rf /tmp/skills-temp

Registering New Skills

注册新Skill

After downloading a skill, it will be automatically discovered on the next message. Skills are discovered from 
~/.letta/skills/
, 
.skills/
, and agent-scoped 
~/.letta/agents/<agent-id>/skills/
directories.
下载完成后，下一次消息交互时系统会自动发现新Skill。Skill会从
~/.letta/skills/
、
.skills/
以及Agent专属的
~/.letta/agents/<agent-id>/skills/
目录中被发现。

Complete Example

完整示例

User asks: "Can you help me test my React app's UI?"
  1. Recognize opportunity: Browser/webapp testing - likely has a skill
  2. Ask user: "Would you like me to look for webapp testing skills, or start coding right away?"
  3. If user agrees, find skill: Check anthropics/skills for webapp-testing
  4. Download (trusted source):
    bash
    git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/
rm -rf /tmp/skills-temp
  5. Inspect scripts: Read any .py or .ts files before using them
  6. Invoke: 
    Skill(skill: "webapp-testing")
  7. Use: Follow the skill's instructions for the user's task
User asks: "Can you help me test my React app's UI?"
  1. Recognize opportunity: Browser/webapp testing - likely has a skill
  2. Ask user: "Would you like me to look for webapp testing skills, or start coding right away?"
  3. If user agrees, find skill: Check anthropics/skills for webapp-testing
  4. Download (trusted source):
    bash
    git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/
rm -rf /tmp/skills-temp
  5. Inspect scripts: Read any .py or .ts files before using them
  6. Invoke: 
    Skill(skill: "webapp-testing")
  7. Use: Follow the skill's instructions for the user's task