技能 Registry
- 作者仓库星标 3,249
- 许可证 MIT
- 作者仓库 gentle-ai
Activation Contract
Use this skill after installing, removing, creating, moving, or renaming skills, or when a delegator needs a fresh skill index.
Hard Rules
- The registry is an index, not a compiler or summary.
SKILL.mdremains the source of truth. - Do not generate or inject compact rules by default; preserve author intent by passing exact skill paths to subagents.
- Always write
.atl/skill-registry.mdregardless of SDD persistence mode. - Save the registry to Engram as
topic_key: skill-registrywhen available, withcapture_prompt: false. - Skip
sdd-*,_shared, andskill-registry; deduplicate by skill name, preferring project-level skills over user-level skills. - Add
.atl/to.gitignorewhen possible unless explicitly disabled.
Decision Gates
| Situation | Action |
|---|---|
| Same skill exists globally and in project | Keep the project-level skill |
| Same skill exists in multiple global locations | Keep the first source in scan order |
| No skills found | Write an empty registry so agents stop searching blindly |
| Agent will delegate work | Select matching registry rows and pass their SKILL.md paths |
Execution Steps
- Scan all known user and project skill directories for
*/SKILL.md. - Read frontmatter only as needed to extract
nameanddescriptiontrigger text. - Render
.atl/skill-registry.mdwith scanned sources, registry contract, skill name, trigger/description, scope, and exact path. - Persist to Engram when available using
title: skill-registry,topic_key: skill-registry,type: config, andcapture_prompt: false. - Return the registry path, skill count, cache status, and whether Engram was updated.
Output Contract
Return:
- Project name and
.atl/skill-registry.mdpath. - Number of indexed skills.
- Whether the cache was hit or regenerated.
- Any skipped or duplicate skills when relevant.
References
docs/skill-style-guide.md— how skills should be authored before indexing.skills/_shared/skill-resolver.md— how delegators use the index.
- 流狐分类
- 通用
- 作者声明 Agent
- 未找到明确声明；不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描，不代表运行安全
- 作者 / 版本 / 许可
- @Gentleman-Programming · MIT
- 流狐 Token 估算
- 低消耗
- 流狐接入估算
- 需简单配置
- 是否需要外部 API Key
- 未发现要求
- 检测到的系统要求
- 未声明
- 底层运行要求
- 未声明
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- Shell 执行
- 检测到的网络行为
- 仅限本地
- 安装命令数
- 无（仅作为资料）
档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。
需要注意： 未限定 allowed-tools，默认拥有全部工具权限。
作者没有在当前 SKILL.md 中定义固定输出样例。Use this skill after installing, removing, creating, moving, or renaming skills, or when a delegator needs a fresh skill index.
The registry is an index, not a compiler or summary. SKILL.md remains the source of truth. Do not generate or inject compact rules by default; preserve author intent by passing exact skill paths to subagents. Always write .atl/skill-registry.md regardless of…
Situation · Action Same skill exists globally and in project · Keep the project-level skill Same skill exists in multiple global locations · Keep the first source in scan order
Scan all known user and project skill directories for /SKILL.md. Read frontmatter only as needed to extract name and description trigger text. Render .atl/skill-registry.md with scanned sources, registry contract, skill name, trigger/description, scope, and…
Return: Project name and .atl/skill-registry.md path. Number of indexed skills.
docs/skill-style-guide.md — how skills should be authored before indexing. skills/shared/skill-resolver.md — how delegators use the index.
## Activation Contract
Use this skill after installing, removing, creating, moving, or renaming skills, or when a delegator needs a fresh skill index.
## Hard Rules
- The registry is an index, not a compiler or summary. `SKILL.md` remains the source of truth.
- Do not generate or inject compact rules by default; preserve author intent by passing exact skill paths to subagents.
- Always write `.atl/skill-registry.md` regardless of SDD persistence mode.
- Save the registry to Engram as `topic_key: skill-registry` when available, with `capture_prompt: false`.
- Skip `sdd-*`, `_shared`, and `skill-registry`; deduplicate by skill name, preferring project-level skills over user-level skills.
- Add `.atl/` to `.gitignore` when possible unless explicitly disabled.
## Decision Gates
| Situation | Action |
| --- | --- |
| Same skill exists globally and in project | Keep the project-level skill |
| Same skill exists in multiple global locations | Keep the first source in scan order |
| No skills found | Write an empty registry so agents stop searching blindly |
| Agent will delegate work | Select matching registry rows and pass their `SKILL.md` paths |
## Execution Steps
1. Scan all known user and project skill directories for `*/SKILL.md`.
2. Read frontmatter only as needed to extract `name` and `description` trigger text.
3. Render `.atl/skill-registry.md` with scanned sources, registry contract, skill name, trigger/description, scope, and exact path.
4. Persist to Engram when available using `title: skill-registry`, `topic_key: skill-registry`, `type: config`, and `capture_prompt: false`.
5. Return the registry path, skill count, cache status, and whether Engram was updated.
## Output Contract
Return:
- Project name and `.atl/skill-registry.md` path.
…作者原文负责流程事实；流狐只索引当前章节、要点、文件与命令。
章节 -> Activation Contract → Hard Rules → Decision Gates → Execution Steps → Output Contract → References
要点 -> Use this skill after installing, removing, creating, moving, or renaming skills, or when a delegator needs a fresh skill index. · - The registry is an index, not a compiler or summary. · 1. Scan all known user and project skill directories for /SKILL.md. · Return: - Project name and .atl/skill-registry.md path. · - docs/skill-style-guide.md — how skills should be authored before indexing.
文件/命令 -> .atl/skill-registry.md · topickey: skill-registry · captureprompt: false · sdd- · shared · skill-registry · .atl/ · .gitignore
内容 SHA-256 -> eb60fef3f354
方法与流程
适用与边界
原文中的明确线索
.atl/skill-registry.md、topickey: skill-registry、captureprompt: false、sdd-、shared、skill-registry、.atl/、.gitignore