mcpField
R
related-skills-surfacer

related-skills-surfacer

github.com/anthropicsAgent workflows9.8k586 installsUpdated 14w ago
Repository

About related-skills-surfacer

A Claude skill that checks a task against a community registry and surfaces strongly related skills that are not already installed. It can be invoked directly or connected to other plugins through a Stop hook configured by those plugins.

Key features

  1. 01Matches tasks against registry skills
  2. 02Filters by practice profile
  3. 03Skips already installed skills
  4. 04Limits repeat suggestions

Use cases

  1. 01Find community skills related to a completed task
  2. 02Discover relevant skills for a legal practice area

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/anthropics/claude-for-legal --skill related-skills-surfacer

After installing, type/related-skills-surfacerin Claude Code to confirm it loaded.

Details

From the project README

/related-skills-surfacer

  1. Load ~/.claude/plugins/config/claude-for-legal/legal-builder-hub/CLAUDE.md → practice profile.
  2. Use the workflow below.
  3. Check what other plugins have been doing. Match against registry.
  4. Suggest: "You've been doing X — community has a skill for Y that's related."

Purpose

The community might have built the thing you're about to build. This skill notices and mentions it — once, briefly, non-annoyingly.

How it runs

This skill surfaces related community skills after a task. It can be invoked directly by the user ("what else is out there for X?") or wired into other plugins via a Stop hook — the hook-based pattern requires each sibling plugin to declare a Stop hook that calls this skill, which is not wired by default. Without the hook wiring, invoke it directly.

Other plugins can include a light check at the end of a task:

"The legal-builder-hub found a community skill that might help with this kind of thing: [name] — [one-line]. Want to take a look?"

Load context

~/.claude/plugins/config/claude-for-legal/legal-builder-hub/CLAUDE.md → practice profile, installed skills (don't suggest what's already installed). Registry cache from registry-browser.

The match

Given a task description (what the user was just doing), find registry skills that match:

  • Keyword overlap between the task and skill descriptions
  • Practice profile fit (don't suggest litigation skills to a transactional lawyer)
  • Not already installed

Threshold: Only surface if the match is strong. Weak matches are noise. Better to surface nothing than to annoy.

Output

If strong match:

💡 The community has a skill for this: [name] from [registry] — "[description]". /legal-builder-hub:skill-installer [name] to try it.

If no strong match: silent. No output. Don't announce "I found nothing."

Frequency limit

Don't surface the same skill twice. If the user didn't install it the first time, they saw it and decided no. Track dismissals in references/surfaced.json.

User control

Per ~/.claude/plugins/config/claude-for-legal/legal-builder-hub/CLAUDE.md → new skill notifications:

  • All: Surface any match
  • Matching practice profile: Filter by profile (default)
  • None: This skill is off

Close with the next-steps decision tree

End with the next-steps decision tree per CLAUDE.md ## Outputs. Customize the options to what this skill just produced — the five default branches (draft the X, escalate, get more facts, watch and wait, something else) are a starting point, not a lock-in. The tree is the output; the lawyer picks.

What this skill does not do

  • Install anything.
  • Interrupt a task in progress. Surfacing happens at the end of a task, not in the middle.
  • Nag. One mention per skill, ever.

Comments

Markdown supported