skill-registry

Scan SKILL.md frontmatter and consolidate skills into a registry file.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/adacosdev/dotfiles --skill skill-registry-adacosdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-registry
Source: https://github.com/adacosdev/dotfiles/tree/main/dot_config/opencode/skills/skill-registry
Command: npx skills add https://github.com/adacosdev/dotfiles --skill skill-registry-adacosdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the discovery and maintenance of a centralized registry of available user- and project-level skills, ensuring consistent loading across tasks.

Core Features & Use Cases

  • Scans user skills across multiple directories for SKILL.md files.
  • Scans project conventions to include index and referenced files.
  • Persists a registry at .atl/skill-registry.md and optionally to engram for cross-session reuse.

Quick Start

Run the skill-registry update to regenerate the registry from your current skills and project conventions.

Frequently Asked Questions about skill-registry

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

FAQPage Schema
How do I automatically build a registry of project skills and conventions?

To build a project skill registry automatically, use a tool that scans every SKILL.md frontmatter across user and project directories to consolidate workspace conventions into a single persisted file. This ensures consistent loading and provides a ready-to-load registry for sub-agents.

What is a centralized skill registry and why do I need one?

A centralized skill registry is a consolidated index of all available user and project-level skills. You need it to automate discovery and ensure consistent skill loading across tasks, preventing manual lookup errors and missing conventions during execution.

How do I scan directories for SKILL.md files to consolidate workspace conventions?

You can scan directories for SKILL.md files by running an automated discovery process that aggregates user-level and project-level frontmatter. This process extracts and consolidates the defined conventions into a centralized markdown file for task reference.

Can I persist a skill registry to engram for cross-session reuse?

Yes, you can persist a skill registry to engram for cross-session reuse. The registry is saved locally to .atl/skill-registry.md and optionally to engram when available, ensuring that sub-agents can reference it before task execution across sessions.

Does the skill registry discovery process require external dependencies?

No, the skill registry discovery process does not require external dependencies. It operates independently by scanning local user and project directories for SKILL.md frontmatter and aggregating the results into a centralized registry file.

When should I not use an automated skill registry for project conventions?

You should not use an automated skill registry if your project lacks structured SKILL.md frontmatter files across directories. The tool relies on scanning these specific files to aggregate workspace conventions, so unstructured documentation will not be discovered or consolidated.