skill-discovery

name	skill-discovery
description	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".
user-invocable	false

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]