skill-registry

Generates the canonical SDD v2 skill registry and compact session rules.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nico0695/ai-tools --skill skill-registry-nico0695
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-registry
Source: https://github.com/nico0695/ai-tools/tree/main/sdd/sdd-v2/skills/skill-registry
Command: npx skills add https://github.com/nico0695/ai-tools --skill skill-registry-nico0695

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Orchestrators in an SDD v2 workflow need a fast, durable way to discover which canonical skills exist and what project rules apply, without re-reading every skill file and config document on each run. ## Core Features & Use Cases - Registry Generation: Scans canonical SDD v2 skills, classifies them as core, support, or shared-contract, and writes .sdd/skill-registry.md with paths, responsibilities, and stage readiness. - Compact Rules Derivation: Extracts session-scoped facts such as artifact root, package manager, quality commands, and language preference from openspec/config.yaml and .sdd/project-map.md. - Refresh Signal Tracking: Records lockfiles, tool configs, and key source directories so later runs know when bootstrap should be refreshed. - Use Case: During sdd-init, when bootstrap is missing or skill resolution previously failed, run this Skill to rebuild the registry so the orchestrator can route phases to the correct SDD skills. ## Quick Start Run the skill-registry skill to rebuild .sdd/skill-registry.md from the canonical SDD v2 skills and current project configuration.

Frequently Asked Questions about skill-registry

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

FAQPage Schema
How do I regenerate the SDD skill registry?▼

Run the skill-registry skill during sdd-init when bootstrap is missing or refresh is recommended. It scans canonical SDD v2 skills, classifies them, and writes the result to .sdd/skill-registry.md.

What does the SDD skill registry contain?▼

The registry contains metadata, a canonical SDD skills table, a support skills table, an optional project-local skills table, a compact rules summary, and tracked refresh signals such as lockfiles and tool configs.

When should the skill registry be refreshed?▼

Refresh it when bootstrap is missing, when a refresh is recommended, when the user explicitly asks, or after skill resolution failed in a previous run. Tracked refresh signals like lockfile or config changes also justify rerunning bootstrap.

Does the registry include host-global or external skills?▼

No. It registers canonical SDD skills, shared contracts affecting routing, and optionally repo-local skills. Host-global skills that are not readable from the repo context are ignored to avoid registry bloat.

Why is skill resolution failing in my SDD workflow?▼

Resolution typically fails when the registry is missing or stale, or when the package location is ambiguous. Rerun the skill-registry skill to rebuild .sdd/skill-registry.md from the canonical skill sources.