技能安装者
- 作者仓库星标 177
- 作者仓库 OpenAgentd
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @lthoangg · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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.
章节与文件索引
按说明文件中的顺序排列。
发现令
技能文件格式
来自网址
从头开始
规则
文件/命令 -> {cwd}/.openagentd/skills/{skill-name}/SKILL.md · {cwd}/.opencode/skills/{skill-name}/SKILL.md · {SKILLS_DIR}/{skill-name}/SKILL.md · ~/.config/opencode/skills/{skill-name}/SKILL.md · {SKILLS_DIR} · {root}/{skill-name}/ · web_fetch · name
内容校验值 -> 660a53a6da20
当前原文的自动摘译,尚未人工审校。
发现令
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获取原始内容。解析出 frontmattername字段——它成为目录名称。将内容写入{SKILLS_DIR}/{name}/SKILL.md。从头开始
如果尚未指定,请询问用户该技能应该做什么。按照上述格式将
SKILL.md写入{SKILLS_DIR}/{name}/SKILL.md。如果有用的话,在同一目录中创建任何支持文件(例如reference.md)。规则
目录名称必须与 frontmatter 中的
name字段匹配(小写,仅连字符)。在未先与用户确认的情况下,切勿覆盖现有技能 - 首先阅读并显示将发生哪些变化。写入后,确认路径和名称,以便用户可以将其添加到代理的skills:列表中。可以立即通过确切名称加载新技能。在受影响的代理在下一回合重建后,它会出现在生成的“可用技能”部分中;如果缓存的技能目录已过时,请使用技能 API/UI 路径或重新启动作为后备。