skill-finder

Compares a proposed task against the skill catalog and recommends one disposition.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill skill-finder-sebaperiesdigit-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-finder
Source: https://github.com/sebaperiesdigit-create/Peries-Skills-Master/tree/main/.claude/skills/skill-finder
Command: npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill skill-finder-sebaperiesdigit-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before building a new skill, you need to know whether an existing skill already covers the task. This Skill audits the current skill catalog in .claude/skills/ and tells you whether to reuse, extend, combine, or create a skill, preventing duplicate or overlapping skill definitions. ## Core Features & Use Cases - Catalog Discovery and Shortlisting: Scans .claude/skills/*/SKILL.md frontmatter to shortlist candidate skills that plausibly overlap the proposed task. - Structured Disposition: Assigns exactly one of six outcomes (USE EXISTING, USE WITH PARAMETERS, COMBINE EXISTING SKILLS, EXTEND EXISTING, CREATE NEW, ESCALATE) using a strict priority order. - Drift Detection: Cross-references CLAUDE.md's skill inventory against the actual skills on disk and reports mismatches. - Use Case: You want a skill that summarizes meeting transcripts. Run this Skill first to learn that an existing summarization skill already covers it with different parameters, avoiding redundant work. ## Quick Start Ask the skill-finder whether an existing skill can handle summarizing weekly meeting transcripts into action items.

Frequently Asked Questions about skill-finder

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

FAQPage Schema
How do I check if a skill already exists for a task?▼

Provide a task description and the skill scans the frontmatter of every SKILL.md in .claude/skills/, shortlists plausible matches, deep-reads only those candidates, and reports whether an existing skill covers the task.

How to decide between extending a skill or creating a new one?▼

The skill applies a strict priority order: reuse first, then parameterize, combine, extend, and only create new when no existing skill or reasonable extension covers the task. The report cites the specific match or gap driving the decision.

Does the skill-finder modify or create skills automatically?▼

No. It is strictly read-only and chat-only, never creating, editing, or deleting files. Acting on its recommendation, such as building or extending a skill, always requires a separate explicit follow-up request.

What happens when CLAUDE.md and the skills directory disagree?▼

The skill reports the drift in a dedicated Catalog Drift section and treats the actual SKILL.md files on disk as the source of truth, rather than silently choosing one version.

What are the limitations of automated skill matching?▼

Matching relies on frontmatter descriptions and shortlisted SKILL.md content, so vague task descriptions trigger a clarifying question first. When evidence is insufficient or the decision involves permissions or ownership, it escalates to a human.