playbooks

home / skills / first-fluke / fullstack-starter / skill-lookup

skill-lookup skill

/.agents/skills/skill-lookup

This skill helps you discover and learn about available Agent Skills by searching and retrieving detailed instructions to solve tasks.

npx playbooks add skill first-fluke/fullstack-starter --skill skill-lookup

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

Files (1)
SKILL.md
962 B
---
name: skill-lookup
description: Discover, retrieve, and learn about available Agent Skills. key capability for finding tools to solve specific problems.
---

# Skill Lookup

This skill allows the Agent to introspect its own capabilities and find the right tool for the job.

## Capabilities

### 1. Search Skills
Find skills by keyword, category, or tag.

- **Query**: "infrastructure", "flutter", "test"
- **Result**: List of matching skills with descriptions.

### 2. Get Skill Details
Retrieve the full instructions (`SKILL.md`) for a specific skill.

## When to Use

- User asks "Do you have a skill for X?"
- Agent is unsure how to perform a specialized task and wants to check if a skill exists.
- "List all available skills."

## How it Works (Conceptual)

The Agent should:
1.  Check the `.agent/skills` directory.
2.  Read the `SKILL.md` frontmatter to match requirements.
3.  Load the full `SKILL.md` if a match is found to learn the instructions.

Overview

This skill provides the Agent with the ability to discover, retrieve, and learn about available agent skills so it can pick the right tool for a task. It is designed to quickly locate skills by keyword, tag, or category and load full skill instructions when a match is found. The result is faster, more accurate tool selection and safer delegation of specialized work.

How this skill works

The Agent scans the local skills directory and reads each skill manifest to build an index of names, tags, categories, and short descriptions. When queried, the skill performs keyword and tag matching to return relevant skill summaries. If a specific skill is chosen, the Agent loads the skill's full instruction content so it can execute or defer to that capability.

When to use it

  • User asks whether a capability exists for a specific problem (e.g., “do you have a skill for infrastructure?”).
  • Agent needs to determine the correct tool before attempting a specialized task.
  • When listing or browsing all available skills to explore functionality.
  • During decision-making to compare multiple candidate skills by description or tags.
  • When onboarding new skills or validating skill metadata and categories.

Best practices

  • Keep skill manifests concise and well-tagged to improve search relevance.
  • Use consistent category and tag conventions across skills for reliable filtering.
  • Prioritize short, clear descriptions that summarize outcomes and constraints.
  • Validate manifests after adding new skills so the index remains accurate.
  • Prefer exact keywords and include common synonyms in tags to aid discovery.

Example use cases

  • Find a skill that provisions cloud infrastructure by searching for "terraform" or "gcp".
  • Discover Flutter-related automation by querying the directory for "flutter" tags.
  • List all testing and CI/CD skills to decide which automation to invoke.
  • Check detailed instructions of a candidate skill before delegating execution.
  • Explore template and monorepo utilities when setting up a fullstack project.

FAQ

How quickly does the skill index update after adding a new skill?

The Agent rescans the skills directory on demand; added skills are discoverable after a quick reindex or when the Agent next performs a search.

Can I search by partial keywords or synonyms?

Yes. The search supports partial matches and benefits from well-chosen tags and synonyms to improve recall.