adacosdev/dotfiles/skill-registry
Claude Code and agent skill by adacosdev/dotfiles
- community
Checking that the SKILL.md file is still in the repository.
Create or update the skill registry for the current project. Scans user skills and project conventions, writes .atl/skill-registry.md, and saves to engram if available. Trigger: When user says "update skills", "skill registry", "actualizar skills", "update registry", or after installing/removing skills.
Install
npx vskill@latest install adacosdev/dotfiles/skill-registrySKILL.md
The same SKILL.md was published earlier as adacosdev/dotfiles/skill-registry.
Purpose
You generate or update the skill registry — a catalog of all available skills (user-level and project-level) that sub-agents read before starting any task. This ensures every sub-agent knows what skills exist and can load the relevant ones.
When to Run
- After installing or removing skills
- After setting up a new project
- When the user explicitly asks to update the registry
- As part of
sdd-init(it calls this same logic)
What to Do
Step 1: Scan User Skills
- Glob for
*/SKILL.mdfiles across ALL known skill directories. Check every path below — scan ALL that exist, not just the first match:
User-level (global skills):
~/.claude/skills/— Claude Code~/.config/opencode/skills/— OpenCode~/.gemini/skills/— Gemini CLI~/.cursor/skills/— Cursor~/.copilot/skills/— VS Code Copilot- The parent directory of this skill file (catch-all for any tool)
Project-level (workspace skills):
{project-root}/.claude/skills/— Claude Code{project-root}/.gemini/skills/— Gemini CLI{project-root}/.agent/skills/— Antigravity (workspace){project-root}/skills/— Generic
- SKIP `sdd-*` and `_shared` — those are SDD workflow skills, not coding/task skills
- Also SKIP `skill-registry` — that's this skill
- Deduplicate — if the same skill name appears in multiple locations, keep the project-level version (more specific). If both are user-level, keep the first found.
- For each skill found, read only the frontmatter (first 10 lines) to extract:
namefielddescriptionfield → extract the trigger text (after "Trigger:" in the description)
- Build a table of: Trigger | Skill Name | Full Path
Step 2: Scan Project Conventions
- Check the project root for convention files. Look for:
agents.mdorAGENTS.mdCLAUDE.md(only project-level, not~/.claude/CLAUDE.md).cursorrulesGEMINI.mdcopilot-instructions.md
- If an index file is found (e.g.,
agents.md,AGENTS.md): READ its contents and extract all referenced file paths. These index files typically list project conventions with paths — extract every referenced path and include it in the registry table alongside the index file itself. - For non-index files (
.cursorrules,CLAUDE.md, etc.): record the file directly. - The final table should include the index file AND all paths it references — zero extra hops for sub-agents.
Step 3: Write the Registry
Build the registry markdown:
Step 4: Persist the Registry
This step is MANDATORY — do NOT skip it.
A. Always write the file (guaranteed availability):
Create the .atl/ directory in the project root if it doesn't exist, then write:
B. If engram is available, also save to engram (cross-session bonus):
topic_key ensures upserts — running again updates the same observation.
Step 5: Return Summary
Rules
- ALWAYS write
.atl/skill-registry.mdregardless of any SDD persistence mode - ALWAYS save to engram if the
mem_savetool is available - SKIP
sdd-*,_shared, andskill-registrydirectories when scanning - Only read frontmatter (first 10 lines) — do NOT read full skill files
- Include ALL convention index files found (not just the first)
- If no skills or conventions are found, write an empty registry (so sub-agents don't waste time searching)
- Add
.atl/to the project's.gitignoreif it exists and.atlis not already listed
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingdot_config/opencode/skills/skill-registry/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/adacosdev/dotfiles/skill-registry)