skills-registry

name	skills-registry
description	Dynamic skill discovery and matching for any task context. Invoke when: - Starting any task to discover relevant skills - Need to find specialized skills for current context - Agent/command needs skill recommendations Trigger phrases: "match skills", "find skills", "what skills for", "recommend skills", "which capabilities", "skill lookup", "applicable skills" Examples: - "Match skills for TDD cycle with zod validation" → outputs backend-zod, backend-vitest - "What skills for React landing page?" → outputs frontend-master, frontend-aceternity
allowed-tools	Read, Grep, Glob

Skills Registry

Dynamic skill matching system. Analyzes task context and recommends skills to apply.

Matching Protocol

Step 1: Extract Context Keywords

From current task/input, identify:

• Action: analyze, fix, create, test, debug, review, implement, setup, deploy
• Domain: frontend, backend, API, database, validation, UI, auth, DevOps
• Tech: React, Next.js, Express, Prisma, tRPC, zod, Playwright, Docker
• Problem: error, bug, issue, failure, lint, type check, debugging

Step 2: Match Against Registry

For each skill in registry:

1. Count keyword matches: (task keywords) ∩ (skill keywords)
2. Check if task situation matches skill's when condition
3. Match if: ≥2 keywords OR when applies

Step 3: Rank Results

Order matched skills by:

1. priority: high → top of list
2. enforcement: required → above suggest
3. More keyword matches → higher rank

Step 4: Output

When matches found:

Matched skills:

**Required:**
- Apply [Skill] skill — [reason]

**Suggested:**
- Apply [Skill] skill — [reason]

When no matches (< 2 keywords, no when applies):

No skills matched.
Context extracted: [keywords]
Clarify domain or tech stack for better matching.

---

Skills Registry Data

Core Skills

Skill	Path	Keywords	When	Priority	Enforcement
feature-analyzer	.claude/skills/feature-analyzer/	feature, artifacts, spec, plan, tasks, data-model, requirements, context, ux, contracts	Loading feature context OR reading documentation artifacts OR need requirements understanding	high	required
code-analyzer	.claude/skills/code-analyzer/	codebase, structure, dependencies, markers, AICODE, imports, modules, architecture, existing code	Need project structure OR dependency analysis OR find existing AICODE markers OR understand architecture	medium	suggest
git	.claude/skills/git/	branch, commit, push, merge, git, repository, checkout, stash	Any git operation — branch creation, commits, pushes, merges	high	required
sequential-thinking	.claude/skills/sequential-thinking/	complex, analysis, multi-step, root cause, debugging, unclear, diagnosis, investigation	Problem requires 3+ logical steps OR unclear root cause OR multiple valid approaches OR low confidence in solution	medium	suggest
context7	.claude/skills/context7/	library, documentation, package, npm, pypi, external, api reference, third-party	Need library documentation OR unfamiliar package OR library-related error OR checking correct API usage	medium	suggest
self-commenting	.claude/skills/self-commenting/	AICODE, marker, NOTE, TODO, FIX, annotation, cross-session, context preservation	Writing code that needs context for future sessions OR documenting non-obvious logic OR leaving markers	low	suggest

Agent & Prompt Skills

Skill	Path	Keywords	When	Priority	Enforcement
agent-creator	.claude/skills/agent-creator/	agent, subagent, create agent, agent template, agent design, specialized agent, domain expert	Creating new agents OR designing agent prompts OR configuring agent tools and models	medium	suggest
self-improve	.claude/skills/self-improve/	intent, interpret, vague request, enrich, synthesize, findings, actionable, user request	Interpreting vague user intent OR preparing context for agent generation OR synthesizing actionable insights from project context	medium	suggest
prompt-optimizer	.claude/skills/prompt-optimizer/	prompt, TCRO, prompt engineering, optimize prompt, improve prompt, prompt template, structure prompt	Crafting prompts for code generation OR improving prompts not getting results OR structuring multi-step workflows OR debugging pattern drift	medium	suggest

Frontend Skills

Skill	Path	Keywords	When	Priority	Enforcement
frontend-master	.claude/skills/frontend-master/	frontend, Next.js, React, Tailwind, UI, components, styling, layout	Starting frontend task OR need decision framework for UI components, animations, assets, or theming	high	suggest
frontend-shadcn	.claude/skills/frontend-shadcn/	shadcn, button, input, dialog, form, table, modal, dropdown, Radix, components	Need standard UI components (buttons, inputs, dialogs, forms, tables) OR building React/Next.js UI	low	suggest
frontend-aceternity	.claude/skills/frontend-aceternity/	aceternity, spotlight, aurora, 3D card, hero effects, dramatic, wow factor, landing page	Need dramatic hero effects, spotlights, aurora backgrounds, 3D hover cards, or text reveal animations	low	suggest
frontend-magic-ui	.claude/skills/frontend-magic-ui/	magic ui, number ticker, marquee, bento grid, mockup, Safari, iPhone, shimmer button, SaaS	Need SaaS landing components like number tickers, logo marquees, bento grids, or device mockups	low	suggest
frontend-lottie	.claude/skills/frontend-lottie/	lottie, animation, loader, spinner, success, error, empty state, decorative	Need simple play/loop animations like loading spinners, success checkmarks, or empty state illustrations	low	suggest
frontend-rive	.claude/skills/frontend-rive/	rive, interactive animation, state machine, hover, click, data-driven, toggle, checkbox	Need animations that react to user input (hover, click, drag) OR have multiple states/transitions OR respond to data values	low	suggest
frontend-color-system	.claude/skills/frontend-color-system/	color, palette, theme, brand color, dark mode, WCAG, contrast, accessibility	Setting up project colors OR creating dark mode OR checking WCAG contrast OR generating theme from brand color	low	suggest
frontend-google-fonts	.claude/skills/frontend-google-fonts/

Backend Skills

Skill	Path	Keywords	When	Priority	Enforcement
backend-master	.claude/skills/backend-master/	backend, API, server, TypeScript backend, Express, Node.js, microservices	Starting backend task OR need decision framework for APIs, auth, database, validation, logging, testing, or deployment	high	suggest
backend-trpc	.claude/skills/backend-trpc/	tRPC, type-safe API, procedure, router, query, mutation, middleware, end-to-end types	Building full-stack TypeScript API OR need type-safe API without GraphQL OR building internal APIs	low	suggest
backend-trpc-openapi	.claude/skills/backend-trpc-openapi/	OpenAPI, REST, Swagger, API documentation, third-party integration, external clients	Need REST endpoints from tRPC OR Swagger documentation OR third-party integrations need REST	low	suggest
backend-zod	.claude/skills/backend-zod/	zod, validation, schema, input validation, type inference, parse, safeParse, coerce	Validating API inputs OR form data OR environment variables OR any data crossing trust boundaries	low	suggest
backend-prisma	.claude/skills/backend-prisma/	prisma, database, ORM, schema, migration, PostgreSQL, MySQL, SQLite	Need database access with TypeScript types OR running migrations OR querying relational data	low	suggest
backend-auth-js	.claude/skills/backend-auth-js/	auth.js, NextAuth, OAuth, GitHub login, Google login, session, JWT, credentials	Building Next.js app with OAuth OR credentials login OR session management	low	suggest
backend-passport-js	.claude/skills/backend-passport-js/	passport, Express auth, JWT authentication, strategy, bearer token, login, register	Building Express API with JWT auth OR need custom auth strategies OR non-Next.js authentication	low	suggest
backend-pino	.claude/skills/backend-pino/	pino, logging, structured logs, JSON logs, request logging, child logger, redact, observability

DevOps Skills

Skill	Path	Keywords	When	Priority	Enforcement
docker-node	.claude/skills/docker-node/	docker, container, Dockerfile, docker-compose, deploy, CI/CD, multi-stage, production	Deploying Node.js application OR need consistent dev environment OR setting up CI/CD OR containerizing API	medium	suggest

---

Examples

Example 1: TDD with Validation

Input: "Implementing user validation with zod schemas, need unit tests"

Output:

Matched skills:

**Suggested:**
- Apply backend-zod skill — validation, zod matched
- Apply backend-vitest skill — unit test, TDD matched

Example 2: ESLint Errors (Required Enforcement)

Input: "ESLint errors after adding new React component, type check failing"

Output:

Matched skills:

**Required:**
- Apply frontend-debug-linting skill — ESLint, type check matched (enforcement: required)

**Suggested:**
- Apply frontend-master skill — React context

Example 3: Complex Problem (Sequential Thinking)

Input: "Root cause analysis of auth failure, unclear why JWT validation fails"

Output:

Matched skills:

**Suggested:**
- Apply sequential-thinking skill — root cause, unclear, analysis matched
- Apply backend-auth-js skill — auth, JWT matched
- Apply backend-passport-js skill — JWT authentication matched