How do I install the Skill Discovery skill?

Run npx skillmds@latest add matrixy/skill-discovery in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Discovery safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Discovery?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Discovery free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skill Discovery?

matrixy (@matrixy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Discovery by matrixy — Agent Skill

Name: Skill Discovery
Author: matrixy

Skill Discovery

Search for and offer to load auto-generated skills that match the user's current task. Use when the user's request might benefit from a previously learned workflow pattern - especially multi-step tasks like "search and fix", "find and update", "read and edit".

matrixy 6a24e6d 2.4 KB Updated Sep 17, 2026

File contents

Auto-Skill Discovery

When the user requests a task that might match a previously learned workflow, search for relevant skills and offer to load them.

When to Invoke This Skill

Use this skill when the user's request:

Involves multiple steps (search + edit, read + modify, find + fix)
Sounds like a repeatable workflow
Mentions patterns like "the usual way" or "like before"
Could benefit from a structured approach

Do NOT use for:

Simple single-step tasks
Questions or explanations
Tasks the user wants done a specific way

Instructions

Step 1: Discover matching skills

Run the discovery script with the user's intent:

python scripts/discover_skill.py "<2-4 word summary of user's task>"

This outputs a formatted prompt showing:

Best matching skill name and confidence
What the skill does
How it runs (inline vs isolated)
A question asking if user wants to load it

Step 2: Present to user

Show the discovery output to the user. Wait for their response.

Step 3: If user approves, load the skill

python scripts/discover_skill.py "<same query>" --auto-load

This outputs the full skill content with clear delimiters. Display it directly - the formatted output contains the instructions you should follow.

Step 4: Follow the loaded skill

The skill content between the ====== delimiters contains your instructions. Follow them to complete the user's task.

Step 5: If user declines or no match

Proceed with the task normally using your standard approach.

Example Flow

User: "Find all the TODO comments and update them"

You: [Run discover_skill.py "find update todos"]

Output:
  ## Skill Discovery
  I found an auto-generated skill that matches your task:
  **search-and-fix-workflow** (confidence: 85%)
  > Search for issues in codebase and fix them systematically
  Would you like me to load this skill?

User: "Yes"

You: [Run discover_skill.py "find update todos" --auto-load]

Output:
  ======================================
  SKILL LOADED: search-and-fix-workflow
  ...instructions...
  ======================================

You: [Follow those instructions to complete the task]

---name: skill-discoverydescription: Search for and offer to load auto-generated skills that match the user's current task. Use when the user's request might benefit from a previously learned workflow pattern - especially multi-step tasks like "search and fix", "find and update", "read and edit".---# Auto-Skill DiscoveryWhen the user requests a task that might match a previously learned workflow, search for relevant skills and offer to load them.## When to Invoke This SkillUse this skill when the user's request:- Involves multiple steps (search + edit, read + modify, find + fix)- Sounds like a repeatable workflow- Mentions patterns like "the usual way" or "like before"- Could benefit from a structured approachDo NOT use for:- Simple single-step tasks- Questions or explanations- Tasks the user wants done a specific way## Instructions### Step 1: Discover matching skillsRun the discovery script with the user's intent:```bashpython scripts/discover_skill.py "<2-4 word summary of user's task>"```This outputs a formatted prompt showing:- Best matching skill name and confidence- What the skill does- How it runs (inline vs isolated)- A question asking if user wants to load it### Step 2: Present to userShow the discovery output to the user. Wait for their response.### Step 3: If user approves, load the skill```bashpython scripts/discover_skill.py "<same query>" --auto-load```This outputs the full skill content with clear delimiters. Display it directly - the formatted output contains the instructions you should follow.### Step 4: Follow the loaded skillThe skill content between the `======` delimiters contains your instructions. Follow them to complete the user's task.### Step 5: If user declines or no matchProceed with the task normally using your standard approach.## Example Flow```User: "Find all the TODO comments and update them"You: [Run discover_skill.py "find update todos"]Output: ## Skill Discovery I found an auto-generated skill that matches your task: **search-and-fix-workflow** (confidence: 85%) > Search for issues in codebase and fix them systematically Would you like me to load this skill?User: "Yes"You: [Run discover_skill.py "find update todos" --auto-load]Output: ====================================== SKILL LOADED: search-and-fix-workflow ...instructions... ======================================You: [Follow those instructions to complete the task]```

Frequently asked questions