依据已读取的 OpenCode 官方文档：原生支持 SKILL.md 技能，并兼容 Claude 与通用 Agent 的指定目录；这些兼容目录仍是 Skills 文件，不代表支持任意格式。技能包的具体作者、许可证、目录完整性和外部依赖因未提供具体包而无法核验。操作系统版本门槛未在本次资料中逐一确认。MCP、自定义命令、AGENTS.md 不等同于 Skill。本轮只查阅官方文档，未下载、安装、登录或实机验证。
준비
- 安装 OpenCode 的终端环境；官方入门页要求现代终端。
- 若要实际运行模型，需要先配置所选模型提供商；本指南不要求登录，也不填写密钥。
- 从 Skills-SI 获取的技能包须有可核验作者与许可，并先检查内容及随附脚本。
설치 및 사용 단계
- 01
准备：确认环境与范围
先决定安装到当前项目还是个人用户目录。官方支持项目级与全局级技能；使用模型还需配置模型提供商。不要把账号、密钥写入技能文件。
opencode --version근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 02
从本站下载并检查完整目录
在 Skills-SI 对应技能页面使用当页实际提供的下载入口；核对作者、许可、版本及文件清单。解压后保留技能完整目录及 references、scripts 等配套资源，阅读 SKILL.md 和脚本；不要只复制 SKILL.md，也不要运行未经审查的脚本。页面按钮名、压缩包名与本机下载位置以实际显示为准。
근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 03
安装 OpenCode（如尚未安装）
官方列出的安装方式包括 npm 全局安装、Homebrew 等；以下命令是官方文档示例之一。也可从 OpenCode 官方 Releases 获取对应系统版本。安装命令仅供读者自行决定执行，本次未运行。
npm install -g opencode-ai근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 04
放入原生 Skills 目录
把解压后的整个技能目录放到项目目录 `.opencode/skills/<技能目录名>/`，或用户目录 `~/.config/opencode/skills/<技能目录名>/`，并保留其中 `SKILL.md` 与资源。SKILL.md 须含 YAML name、description；name 应为小写字母数字和单连字符，且与目录名相同。项目目录会从当前工作目录向上查找至 Git worktree。
.opencode/skills/<技能目录名>/SKILL.md 或 ~/.config/opencode/skills/<技能目录名>/SKILL.md근거와 출처.opencode/skills/<技能目录名>/SKILL.md 或 ~/.config/opencode/skills/<技能目录名>/SKILL.md작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 05
调用并做第一项练习
在项目目录启动 OpenCode。它会在 skill 工具说明中列出可用技能，并可按名称加载。用虚构会议资料练习：请技能将三条虚构讨论整理成行动项，标注负责人、期限和待确认事项；检查内容，不要使用真实客户信息。
opencode근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 06
验证并按需卸载
核对技能是否出现在可用技能清单、能否按名称加载，以及练习输出是否符合预期。卸载单项时只移除对应的项目技能目录或用户技能目录。若还要卸载 OpenCode，先查看官方卸载预览并备份需要保留的配置；卸载程序可能移除相关文件。
.opencode/skills/<技能目录名>/ 或 ~/.config/opencode/skills/<技能目录名>/opencode uninstall --dry-run근거와 출처.opencode/skills/<技能目录名>/ 或 ~/.config/opencode/skills/<技能目录名>/작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다.
연습 및 검수
用一段完全虚构的三条会议讨论，要求技能输出行动项、负责人、期限和待确认事项；逐条检查是否忠于输入。
- 运行 `opencode --version` 确认命令可用。
- 启动 OpenCode，在技能工具的可用技能列表确认技能名称与描述；官方文档说明可按名称加载。
- 加载后用虚构会议输入练习，检查行动项是否仅依据输入、字段是否齐全。
- 若未出现，核对 SKILL.md 文件名大小写、name/description、目录名匹配、名称重复及技能权限。
비활성화 및 삭제
- 单项卸载：关闭会话后，只删除已安装的对应项目级 `.opencode/skills/<技能目录名>/`，或用户级 `~/.config/opencode/skills/<技能目录名>/`；不要误删其他技能。
- 完整卸载 OpenCode 前，先运行 `opencode uninstall --dry-run` 查看将移除内容并备份要保留的配置、数据和技能。确认后再按官方卸载命令或原安装方式卸载；如需保留配置或会话数据，查阅命令选项后明确保留。
문제 해결
技能没有出现在可用技能清单。
检查完整目录是否位于官方支持位置，文件名是否准确为大写 `SKILL.md`，frontmatter 是否含 name 和 description，name 是否匹配目录名且未与其他位置重复。
技能被隐藏或加载遭拒。
检查 OpenCode 配置中 `permission.skill` 对应名称的规则；`deny` 会隐藏并拒绝加载，`ask` 会请求批准。只对可信技能作必要调整。
技能出现但提示缺少参考文件或脚本。
重新从下载包解压并保留完整技能目录及相对结构；不要只拷贝 SKILL.md。先阅读相关文件，不要为排障关闭防护。
OpenCode 能启动但无法完成练习。
技能是否加载与模型调用是两回事；确认模型提供商配置和网络可用性，不要把凭据写入技能包，也不要把 MCP 配置当成 Skills 安装。
근거와 출처
- https://opencode.ai/docs/skills/
原生技能目录、Claude/Agent兼容目录、SKILL.md前置字段和命名、发现/按名称加载、技能权限及故障检查。
- https://opencode.ai/docs/
OpenCode终端/桌面/IDE形态、终端前置条件、官方安装方式及启动项目的入门流程。
- https://opencode.ai/docs/permissions/
权限规则 allow/ask/deny、skill 权限类型及权限配置说明。
- https://opencode.ai/docs/cli/
CLI版本选项及 `opencode uninstall --dry-run`、卸载配置选项等命令说明。