技能安装者

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

发现令

OpenAgentd 按此顺序从五个根源发现技能。第一个具有给定名称的技能获胜:{cwd}/.openagentd/skills/{skill-name}/SKILL.md — 项目特定的 OpenAgentd 技能。 {cwd}/.opencode/skills/{skill-name}/SKILL.md — 项目开放代码兼容技能。 {SKILLS_DIR}/{skill-name}/SKILL.md — 全局 OpenAgentd 技能。

技能文件格式

技能是位于{root}/{skill-name}/的目录,至少包含一个SKILL.md文件。 SKILL.md 有 YAML frontmatter 和 Markdown body:

来自网址

使用web_fetch获取原始内容。解析出 frontmatter name 字段——它成为目录名称。将内容写入{SKILLS_DIR}/{name}/SKILL.md。

从头开始

如果尚未指定,请询问用户该技能应该做什么。按照上述格式将SKILL.md写入{SKILLS_DIR}/{name}/SKILL.md。如果有用的话,在同一目录中创建任何支持文件(例如reference.md)。

规则

目录名称必须与 frontmatter 中的 name 字段匹配(小写,仅连字符)。在未先与用户确认的情况下,切勿覆盖现有技能 - 首先阅读并显示将发生哪些变化。写入后,确认路径和名称,以便用户可以将其添加到代理的skills:列表中。可以立即通过确切名称加载新技能。在受影响的代理在下一回合重建后,它会出现在生成的“可用技能”部分中;如果缓存的技能目录已过时,请使用技能 API/UI 路径或重新启动作为后备。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@lthoangg · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Skill Installer

## Discovery order

OpenAgentd discovers skills from five roots, in this order. The first skill
with a given name wins:

1. `{cwd}/.openagentd/skills/{skill-name}/SKILL.md` — project-specific OpenAgentd skill.
2. `{cwd}/.opencode/skills/{skill-name}/SKILL.md` — project opencode-compatible skill.
3. `{SKILLS_DIR}/{skill-name}/SKILL.md` — global OpenAgentd skill.
4. `~/.config/opencode/skills/{skill-name}/SKILL.md` — global opencode-compatible skill.
5. Bundled OpenAgentd operational skills — read-only fallback.

Default to `{SKILLS_DIR}` for user-global installs unless the user explicitly
asks for a project-local skill or an opencode-shared skill.
If the target name already exists only as a bundled skill, install an override
in `{SKILLS_DIR}` (or the requested project root); never edit bundled files.

## Skill file format

A skill is a directory at `{root}/{skill-name}/` containing at minimum a `SKILL.md` file. The `SKILL.md` has YAML frontmatter and a Markdown body:

```markdown
---
name: skill-name
description: One-sentence description shown in the system prompt.
---

# Skill Title

Full instructions the agent reads when it calls skill("skill-name").
```

## How to install

### From a URL

1. Fetch the raw content with `web_fetch`.
2. Parse out the frontmatter `name` field — that becomes the directory name.
3. Write the content to `{SKILLS_DIR}/{name}/SKILL.md`.

### From scratch

1. Ask the user what the skill should do if not already specified.
2. Write a `SKILL.md` following the format above to `{SKILLS_DIR}/{name}/SKILL.md`.
3. Create any supporting files (e.g. `reference.md`) in the same directory if useful.

## Rules

- Directory name must match the `name` field in frontmatter (lowercase, hyphens only).
- Never overwrite an existing skill without confirming with the user first — read it first and show what will change.
- After writing, confirm the path and name so the user can add it to an agent's `skills:` list.
- A new skill can be loaded by exact name immediately. It appears in generated "Available skills" sections after the affected agent rebuilds on its next turn; if a cached skill catalog is stale, use the Skills API/UI path or restart as a fallback.

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。