playbooks

home / skills / f / prompts.chat / skill-lookup

skill-lookup skill

/plugins/claude/prompts.chat/skills/skill-lookup

This skill helps you discover, retrieve, and install reusable agent capabilities for Claude by searching and managing skills.

npx playbooks add skill f/prompts.chat --skill skill-lookup

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.3 KB
---
name: skill-lookup
description: Activates when the user asks about Agent Skills, wants to find reusable AI capabilities, needs to install skills, or mentions skills for Claude. Use for discovering, retrieving, and installing skills.
---

When the user needs Agent Skills, wants to extend Claude's capabilities, or is looking for reusable AI agent components, use the prompts.chat MCP server.

## When to Use This Skill

Activate this skill when the user:

- Asks for Agent Skills ("Find me a code review skill")
- Wants to search for skills ("What skills are available for testing?")
- Needs to retrieve a specific skill ("Get skill XYZ")
- Wants to install a skill ("Install the documentation skill")
- Mentions extending Claude's capabilities with skills

## Available Tools

Use these prompts.chat MCP tools:

- `search_skills` - Search for skills by keyword
- `get_skill` - Get a specific skill by ID with all its files

## How to Search for Skills

Call `search_skills` with:

- `query`: The search keywords from the user's request
- `limit`: Number of results (default 10, max 50)
- `category`: Filter by category slug (e.g., "coding", "automation")
- `tag`: Filter by tag slug

Present results showing:
- Title and description
- Author name
- File list (SKILL.md, reference docs, scripts)
- Category and tags
- Link to the skill

## How to Get a Skill

Call `get_skill` with:

- `id`: The skill ID

Returns the skill metadata and all file contents:
- SKILL.md (main instructions)
- Reference documentation
- Helper scripts
- Configuration files

## How to Install a Skill

When the user asks to install a skill:

1. Call `get_skill` to retrieve all files
2. Create the directory `.claude/skills/{slug}/`
3. Save each file to the appropriate location:
   - `SKILL.md` → `.claude/skills/{slug}/SKILL.md`
   - Other files → `.claude/skills/{slug}/{filename}`

## Skill Structure

Skills contain:
- **SKILL.md** (required) - Main instructions with frontmatter
- **Reference docs** - Additional documentation files
- **Scripts** - Helper scripts (Python, shell, etc.)
- **Config files** - JSON, YAML configurations

## Guidelines

- Always search before suggesting the user create their own skill
- Present search results in a readable format with file counts
- When installing, confirm the skill was saved successfully
- Explain what the skill does and when it activates

Overview

This skill helps you discover, retrieve, and install reusable AI agent capabilities for Claude and similar agents. It connects to the prompts.chat MCP tools to search available skills, fetch full skill packages, and guide local installation into your agent environment. Use it to extend agent functionality quickly with community-created components.

How this skill works

The skill queries the prompts.chat MCP index to search skills by keywords, category, or tag and returns concise search results with metadata and file counts. When retrieving a specific skill it fetches all files and metadata for that skill. For installation, it provides step-by-step instructions to save the files into the agent's skills directory so the agent can activate the new capability.

When to use it

  • When you ask to find or list available agent skills (e.g., "Find a code review skill").
  • When you want to retrieve a full skill package by name or ID.
  • When you ask to install a skill into your local Claude agent environment.
  • When you want to filter skills by category or tag for specific use cases.
  • When you need the file list and metadata for a skill before deploying it.

Best practices

  • Always run a search before recommending creating a new skill to avoid duplicates.
  • Use keyword, category, and tag filters to narrow results and reduce noise.
  • Review the skill metadata and file list before installation to confirm intent and dependencies.
  • After installation, confirm files were saved to the expected directory and test the skill in a safe environment.
  • Keep installed skills in a dedicated skills directory to simplify updates and backups.

Example use cases

  • Search for automation skills that wire into CI/CD pipelines and retrieve candidate skills.
  • Fetch a documentation-generation skill, inspect its files and helper scripts, then install it locally.
  • Install a community prompt collection for code review and run tests to validate outputs.
  • Filter skills by the "coding" category to assemble a toolkit for developer assistants.
  • Retrieve a specific skill ID provided by a colleague and install it for internal use.

FAQ

What filters can I use when searching?

You can filter by keyword query, result limit, category slug, and tag slug to narrow search results.

How does installation work?

Installation fetches all files for the chosen skill and saves them into a dedicated skills directory in your agent environment, then you should verify files were saved and test the skill.