<< All versions
Skill v1.0.2
currentAutomated scan100/100gentleman-programming/gentle-ai/skill-registry
~1 modified
──Details
PublishedNovember 15, 2026 at 11:49 AM
Content Hashsha256:29da5440e0f2d5fe...
Git SHA4309309fa90c
Bump Typepatch
──Files
Files (1 file, 2.5 KB)
SKILL.md2.5 KBactive
SKILL.md · 51 lines · 2.5 KB
name: skill-registry description: "Trigger: update skills, skill registry, actualizar skills, after skill changes. Index available skills by trigger and path." license: MIT metadata: author: gentleman-programming version: "1.0"
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.
- Refresh the shared disk index with
gentle-ai skill-registry refresh --cwd <project>; it owns discovery, ordering, deduplication, and publication. Scan by hand only when that command is unavailable; use results for inspection, never publish a hand-rendered index. - The shared file excludes Pi session-only runtime skills. Pi delegators select from their current effective session view; other delegators read the current disk index.
- Never substitute a stored Engram or session copy for the current disk index, or persist Pi's session-local effective view.
- 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 | Let refresh produce an empty disk index | |
| Agent will delegate work | Select matching rows from the current effective view and pass exact SKILL.md paths |
Execution Steps
- Run
gentle-ai skill-registry refresh --cwd <project>; every refresh rescans, and--forcealso leaves identical bytes untouched. - If skipped (not a project), unavailable, or failed, report that outcome. A read-only hand scan is optional only if the command is unavailable; do not write its results as the shared index.
- For delegation, use the current disk index or Pi's effective session view and pass matching exact paths.
- Return the registry path, skill count when reported, and whether the index changed.
Output Contract
Return:
- Project name and
.atl/skill-registry.mdpath. - Number of indexed skills.
- Whether the index changed or was already current.
- 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.