mc-skill-broker

# Skill broker — cross-project skill discovery Clayrune merges global skills + the current project's skills into your active set at session start. **It does NOT show you skills authored inside OTHER projects.** This skill bridges that gap. ## When to call this - You're about to write a procedure from scratch and suspect one already exists. - The user says "we have a playbook for this somewhere" — but you don't see it. - The user asks "do we have a skill for X?" — even if you have a partial match, search to be sure. - A task in one project resembles work done in another. Do NOT call this skill for: - General web searches or Anthropic documentation lookups. - Tasks fully covered by a skill already in your active set. ## How to use ### 1. Search ```bash curl -s "http://localhost:5199/api/skills/search?q=<task+description>&limit=10" ``` Use natural-language keywords. The endpoint scores skills by keyword overlap across name, description, and body. Response shape: ```json [ {"name": "release-checklist", "scope": "project", "project_id": "foo", "description": "...", "body_excerpt": "...", "score": 6.0} ] ``` ### 2. Inspect candidates For any high-scoring candidate, read its full body: ```bash # Global skill curl -s "http://localhost:5199/api/skills/global/<name>?include_body=true" # Project-scoped skill curl -s "http://localhost:5199/api/skills/project/<name>?project_id=<pid>&include_body=true" ``` ### 3. Decide how to use it Two patterns, depending on user cont...