mcpField
S
skill-lookup

skill-lookup

github.com/fAgent workflows174.9k2.5k installsUpdated today
Repository

About skill-lookup

skill-lookup guides agents through finding, retrieving, and installing skills with prompts.chat. It is intended for workflows that discover skills for users and verify their installation.

Key features

  1. 01Search by keyword, category, or tag
  2. 02Retrieve skill metadata and files
  3. 03Install files in the specified directory
  4. 04Verify SKILL.md and explain activation

Use cases

  1. 01Find an existing code review skill
  2. 02Retrieve a skill’s complete files
  3. 03Install and check a skill in a project

MCP support

Uses the prompts.chat MCP tools search_skills and get_skill to find skills and retrieve their files.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/f/prompts.chat --skill skill-lookup

After installing, type/skill-lookupin Claude Code to confirm it loaded.

Details

From the project README

Workflow

  1. Search for skills matching the user's request using search_skills
  2. Present results with title, description, author, and file list
  3. If the user picks a skill, retrieve it with get_skill to get all files
  4. Install by saving files to .claude/skills/{slug}/ and verify the SKILL.md exists
  5. Confirm installation and explain what the skill does and when it activates

Example

search_skills({"query": "code review", "limit": 5, "category": "coding"})
get_skill({"id": "abc123"})

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}
  4. Read back SKILL.md to verify the frontmatter is intact

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

Comments

Markdown supported