skills.rest
albersg
albersgCOMMUNITY
Explore all skills by this author →
GitHub

skill-registry

Indexes available skills by trigger and path into a registry file.

Updated Mar 7, 2026
Search Tags:#automation#indexing#agent delegation#opencode#skill.md#engram#skill registry
One-click install
npx skills add https://github.com/albersg/dotfiles --skill skill-registry-albersg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-registry
Source: https://github.com/albersg/dotfiles/tree/main/dotfiles-opencode/.opencode/skills/skill-registry
Command: npx skills add https://github.com/albersg/dotfiles --skill skill-registry-albersg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After installing, removing, or renaming skills, delegating agents lose track of which skills exist and where they live. This Skill rebuilds a fresh index of all available skills so agents stop searching blindly and always reference the correct SKILL.md paths. ## Core Features & Use Cases - Skill Indexing: Scans user and project skill directories for SKILL.md files and records each skill's name, trigger description, scope, and exact path. - Deduplication Rules: Prefers project-level skills over global ones and skips internal entries like sdd-*, _shared, and skill-registry itself. - Persistent Registry: Always writes .atl/skill-registry.md and optionally persists the index to Engram under the topic key skill-registry. - Use Case: After adding a new skill to your OpenCode setup, run this Skill so delegator agents receive an up-to-date registry with exact SKILL.md paths for subagent delegation. ## Quick Start Update the skill registry to index all current skills after my recent skill changes.

Frequently Asked Questions about skill-registry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update the skill registry after adding new skills?▼

Trigger the skill-registry skill after installing, removing, creating, moving, or renaming any skill. It rescans all user and project skill directories for SKILL.md files and rewrites .atl/skill-registry.md with the updated index.

What is a skill registry used for in agent delegation?▼

A skill registry is an index that maps skill names and trigger descriptions to their exact SKILL.md paths. Delegator agents read it to select matching skills and pass precise paths to subagents instead of searching directories blindly.

What happens when the same skill exists globally and in a project?▼

The registry deduplicates by skill name and keeps the project-level skill over the user-level one. If duplicates exist across multiple global locations, the first source in scan order is kept.

Where is the skill registry file stored?▼

The registry is always written to .atl/skill-registry.md regardless of SDD persistence mode, and .atl/ is added to .gitignore when possible. It can also be persisted to Engram under the topic key skill-registry when available.

Which skills are excluded from the registry index?▼

Skills prefixed with sdd-, the _shared directory, and the skill-registry skill itself are skipped during indexing. If no skills are found, an empty registry is still written so agents stop searching.

Related Skills

Explore More Software Engineering Skills→
sujithatzackriyasujithatzackriya

skill-create

Generate a structured SKILL.md with validated frontmatter and routing triggers.

Community
Advanced
porcupine-mdporcupine-md
11

gateway-backend

Route backend task descriptions to matching library skill SKILL.md paths.

Official
Intermediate
Gentleman-ProgrammingGentleman-Programming
5.5k

skill-registry

Generates and updates a project skill registry markdown file.

Official
Intermediate
githubnextgithubnext
5.1k

skillz-integration

Integrates the Skillz MCP server via Docker to run SKILL.md-based skills in agentic workflows.

Official
Intermediate