| name | gentle-ai-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.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
- 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 exact path.
- Persist to Engram when available using
title: skill-registry, topic_key: skill-registry, type: config, and capture_prompt: false.
- Return the registry path, skill count, cache status, and whether Engram was updated.
Output Contract
Return:
- Project name and
.atl/skill-registry.md path.
- 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.
