Back to Details

repo-skill-installer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Repo Skill Installer

仓库Skill安装器

Use this skill when a skill should be hosted by this repository.

当某个Skill需要由本仓库托管时，请使用此工具。

Workflow

工作流程

Resolve the skill source.
- For third-party skills, prefer the GitHub repo path and skill name.
- For manually hosted skills, use
```
skills/<skill-name>/
```
  as the canonical source.
Update the canonical source.
- Put repo-owned skills under
```
skills/<skill-name>/
```
  .
- Do not vendor third-party payloads there.
- Keep
```
.agents/skills/
```
  as installer output only.
Register the lock entry.
- Use
```
skills-lock.json
```
  as the only source/ref/hash metadata file.
- For repo-owned skills, use this public repo path:
```
https://github.com/HGZahn/agentic-coding/tree/master/skills/<skill-name>
```
  .
Rebuild installed output.
- Install locked skills with
```
npx skills
```
  for Codex and opencode.
- Recompute
```
computedHash
```
  from
```
.agents/skills/<skill-name>
```
  .
Sanity-check the result.
- Confirm only intended canonical skills, commands, and lock entries changed.
- Confirm installed
```
.agents/skills
```
  payloads remain ignored.

解析Skill源
- 对于第三方Skill，优先使用GitHub仓库路径和Skill名称。
- 对于手动托管的Skill，使用
```
skills/<skill-name>/
```
  作为标准源。
更新标准源
- 将仓库自有Skill存放于
```
skills/<skill-name>/
```
  目录下。
- 请勿将第三方代码包存放在此目录。
- 仅将
```
.agents/skills/
```
  作为安装器输出目录。
注册锁定条目
- 将
```
skills-lock.json
```
  作为唯一的源/引用/哈希元数据文件。
- 对于仓库自有Skill，使用此公开仓库路径：
```
https://github.com/HGZahn/agentic-coding/tree/master/skills/<skill-name>
```
  。
重建安装输出
- 使用
```
npx skills
```
  为Codex和opencode安装已锁定的Skill。
- 从
```
.agents/skills/<skill-name>
```
  重新计算
```
computedHash
```
  。
结果合理性检查
- 确认仅预期的标准Skill、命令和锁定条目发生了变更。
- 确认已安装的
```
.agents/skills
```
  代码包仍处于忽略状态。

Guardrails

防护规则

Do not run broad updates unless every locked skill should refresh.
Do not modify unrelated commands or skills.
If the source path is ambiguous, stop and resolve it before copying files.
If the skill contains only
```
SKILL.md
```
, do not invent extra folders.

除非所有已锁定的Skill都需要刷新，否则不要执行大范围更新。
不要修改无关的命令或Skill。
如果源路径不明确，请先解决路径问题再复制文件。
如果Skill仅包含
```
SKILL.md
```
文件，请勿创建额外文件夹。

Output

输出

When finished, report:

the skill name
the source repository/path
the canonical files changed under
```
skills/
```
whether the lockfile hash matches installed output

完成后，请报告以下内容：

Skill名称
源仓库/路径
```
skills/
```
目录下变更的标准文件
锁定文件哈希是否与安装输出匹配