skills-registry

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

$ Installer

git clone https://github.com/petbrains/mvp-builder /tmp/mvp-builder && cp -r /tmp/mvp-builder/.claude/skills/skills-registry ~/.claude/skills/mvp-builder

// tip: Run this command in your terminal to install the skill


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

SkillPathKeywordsWhenPriorityEnforcement
feature-analyzer.claude/skills/feature-analyzer/feature, artifacts, spec, plan, tasks, data-model, requirements, context, ux, contractsLoading feature context OR reading documentation artifacts OR need requirements understandinghighrequired
code-analyzer.claude/skills/code-analyzer/codebase, structure, dependencies, markers, AICODE, imports, modules, architecture, existing codeNeed project structure OR dependency analysis OR find existing AICODE markers OR understand architecturemediumsuggest
git.claude/skills/git/branch, commit, push, merge, git, repository, checkout, stashAny git operation — branch creation, commits, pushes, mergeshighrequired
sequential-thinking.claude/skills/sequential-thinking/complex, analysis, multi-step, root cause, debugging, unclear, diagnosis, investigationProblem requires 3+ logical steps OR unclear root cause OR multiple valid approaches OR low confidence in solutionmediumsuggest
context7.claude/skills/context7/library, documentation, package, npm, pypi, external, api reference, third-partyNeed library documentation OR unfamiliar package OR library-related error OR checking correct API usagemediumsuggest
self-commenting.claude/skills/self-commenting/AICODE, marker, NOTE, TODO, FIX, annotation, cross-session, context preservationWriting code that needs context for future sessions OR documenting non-obvious logic OR leaving markerslowsuggest

Agent & Prompt Skills

SkillPathKeywordsWhenPriorityEnforcement
agent-creator.claude/skills/agent-creator/agent, subagent, create agent, agent template, agent design, specialized agent, domain expertCreating new agents OR designing agent prompts OR configuring agent tools and modelsmediumsuggest
self-improve.claude/skills/self-improve/intent, interpret, vague request, enrich, synthesize, findings, actionable, user requestInterpreting vague user intent OR preparing context for agent generation OR synthesizing actionable insights from project contextmediumsuggest
prompt-optimizer.claude/skills/prompt-optimizer/prompt, TCRO, prompt engineering, optimize prompt, improve prompt, prompt template, structure promptCrafting prompts for code generation OR improving prompts not getting results OR structuring multi-step workflows OR debugging pattern driftmediumsuggest

Frontend Skills

SkillPathKeywordsWhenPriorityEnforcement
frontend-master.claude/skills/frontend-master/frontend, Next.js, React, Tailwind, UI, components, styling, layoutStarting frontend task OR need decision framework for UI components, animations, assets, or theminghighsuggest
frontend-shadcn.claude/skills/frontend-shadcn/shadcn, button, input, dialog, form, table, modal, dropdown, Radix, componentsNeed standard UI components (buttons, inputs, dialogs, forms, tables) OR building React/Next.js UIlowsuggest
frontend-aceternity.claude/skills/frontend-aceternity/aceternity, spotlight, aurora, 3D card, hero effects, dramatic, wow factor, landing pageNeed dramatic hero effects, spotlights, aurora backgrounds, 3D hover cards, or text reveal animationslowsuggest
frontend-magic-ui.claude/skills/frontend-magic-ui/magic ui, number ticker, marquee, bento grid, mockup, Safari, iPhone, shimmer button, SaaSNeed SaaS landing components like number tickers, logo marquees, bento grids, or device mockupslowsuggest
frontend-lottie.claude/skills/frontend-lottie/lottie, animation, loader, spinner, success, error, empty state, decorativeNeed simple play/loop animations like loading spinners, success checkmarks, or empty state illustrationslowsuggest
frontend-rive.claude/skills/frontend-rive/rive, interactive animation, state machine, hover, click, data-driven, toggle, checkboxNeed animations that react to user input (hover, click, drag) OR have multiple states/transitions OR respond to data valueslowsuggest
frontend-color-system.claude/skills/frontend-color-system/color, palette, theme, brand color, dark mode, WCAG, contrast, accessibilitySetting up project colors OR creating dark mode OR checking WCAG contrast OR generating theme from brand colorlowsuggest
frontend-google-fonts.claude/skills/frontend-google-fonts/fonts, typography, Google Fonts, font pairing, Inter, Plus Jakarta, headings, body textSetting up project fonts OR need font pairing recommendations OR optimizing font loadinglowsuggest
frontend-iconify.claude/skills/frontend-iconify/icon, iconify, lucide, heroicons, SVG, icon search, icon setNeed to find icons by concept OR integrate icon library OR download SVG iconslowsuggest
frontend-image-generation.claude/skills/frontend-image-generation/avatar, placeholder, photo, illustration, DiceBear, Unsplash, unDraw, image assetsNeed avatars, placeholder photos, or illustrations — use FREE resources first (DiceBear, Unsplash, unDraw)lowsuggest
frontend-debug-linting.claude/skills/frontend-debug-linting/lint, ESLint, TypeScript, type check, Prettier, format, debug, console errorsAfter writing React/Next.js code OR before delivery OR debugging frontend issuesmediumrequired
frontend-playwright.claude/skills/frontend-playwright/playwright, screenshot, browser, visual QA, responsive, viewport, console errors, UI testingBefore delivering UI changes OR need visual verification OR responsive testing OR debugging hydration issueslowrequired
frontend-design-review.claude/skills/frontend-design-review/design review, UI review, UX, visual polish, accessibility, WCAG, responsive design, component standardsBuilding new interfaces OR reviewing visual changes OR validating design quality OR accessibility compliancemediumsuggest

Backend Skills

SkillPathKeywordsWhenPriorityEnforcement
backend-master.claude/skills/backend-master/backend, API, server, TypeScript backend, Express, Node.js, microservicesStarting backend task OR need decision framework for APIs, auth, database, validation, logging, testing, or deploymenthighsuggest
backend-trpc.claude/skills/backend-trpc/tRPC, type-safe API, procedure, router, query, mutation, middleware, end-to-end typesBuilding full-stack TypeScript API OR need type-safe API without GraphQL OR building internal APIslowsuggest
backend-trpc-openapi.claude/skills/backend-trpc-openapi/OpenAPI, REST, Swagger, API documentation, third-party integration, external clientsNeed REST endpoints from tRPC OR Swagger documentation OR third-party integrations need RESTlowsuggest
backend-zod.claude/skills/backend-zod/zod, validation, schema, input validation, type inference, parse, safeParse, coerceValidating API inputs OR form data OR environment variables OR any data crossing trust boundarieslowsuggest
backend-prisma.claude/skills/backend-prisma/prisma, database, ORM, schema, migration, PostgreSQL, MySQL, SQLiteNeed database access with TypeScript types OR running migrations OR querying relational datalowsuggest
backend-auth-js.claude/skills/backend-auth-js/auth.js, NextAuth, OAuth, GitHub login, Google login, session, JWT, credentialsBuilding Next.js app with OAuth OR credentials login OR session managementlowsuggest
backend-passport-js.claude/skills/backend-passport-js/passport, Express auth, JWT authentication, strategy, bearer token, login, registerBuilding Express API with JWT auth OR need custom auth strategies OR non-Next.js authenticationlowsuggest
backend-pino.claude/skills/backend-pino/pino, logging, structured logs, JSON logs, request logging, child logger, redact, observabilityNeed structured logging for production OR request tracing OR sensitive data redactionmediumsuggest
backend-vitest.claude/skills/backend-vitest/vitest, test, unit test, mock, describe, expect, coverage, TDDWriting unit tests OR testing tRPC procedures OR testing Zod schemas OR need fast test runnerlowsuggest

DevOps Skills

SkillPathKeywordsWhenPriorityEnforcement
docker-node.claude/skills/docker-node/docker, container, Dockerfile, docker-compose, deploy, CI/CD, multi-stage, productionDeploying Node.js application OR need consistent dev environment OR setting up CI/CD OR containerizing APImediumsuggest

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