antigravity-claudekit/skills/ck-find-skills/SKILL.md

name, description

name	description
ck-find-skills	Discovers and recommends relevant skills from the skills catalog. Activate when user says 'what skills are available', 'find a skill for', 'which skill should I use', 'list all skills', 'search skills', or 'what can you do'. Accepts task descriptions and domain keywords to match against the skills index.

Overview

Queries the skills catalog (skills_index.json) to surface relevant skills for a given task. Returns skill names, descriptions, and activation triggers to help users discover the right tool.

When to Use

• User is unsure which skill applies to their task
• Exploring what capabilities are available in the current installation
• Building a workflow and need to identify which skills to chain
• Verifying a skill exists before referencing it in a plan

Don't Use When

• User already knows which skill they want (just activate it directly)
• Creating a new skill (use ck-skill-creator instead)
• Searching for non-skill files in the codebase (use file search tools)

Steps / Instructions

1. Locate the Skills Index

The skills catalog is stored at:

# Antigravity global install:
~/.gemini/antigravity/skills/skills_index.json

# Workspace install:
.agent/skills/skills_index.json

2. Parse the Index

The skills_index.json structure:

{
  "skills": [
    {
      "name": "ck-scout",
      "description": "Explores codebase structure...",
      "category": "core-workflow",
      "triggers": ["explore codebase", "understand project", "map the code"]
    }
  ]
}

3. Search Strategy

By keyword match:

• Extract keywords from user's task description
• Match against name, description, and triggers fields
• Return top 3–5 matches with relevance reasoning

By category:

core-workflow:    brainstorm, planning, code-review, debug, fix, git, scout, research
development:      frontend-*, backend-*, web-*, databases, devops
specialized:      ai-artist, ai-multimodal, agent-browser, media-processing, shader
orchestration:    ccs-delegation, skill-creator, find-skills

By task type:

User goal	Recommended skill
Start a new feature	ck-brainstorm → ck-planning
Fix a bug	ck-debug → ck-fix
Review code	ck-code-review
Build UI	ck-frontend-design → ck-frontend-development
Set up auth	ck-better-auth
Generate images	ck-ai-artist
Analyze images/docs	ck-ai-multimodal
Automate browser	ck-agent-browser
Build MCP server	ck-mcp-builder
Process video/audio	ck-media-processing
Deploy infrastructure	ck-devops

4. Format the Response

## Skills Found for: "[user query]"

### Best Match
**ck-[name]** — [one-line description]
Activate with: "[trigger phrase]"

### Also Relevant
- **ck-[name2]** — [description]
- **ck-[name3]** — [description]

### Suggested Workflow
[If task needs multiple skills, show the chain]
ck-scout → ck-planning → ck-frontend-development → ck-web-testing

5. Handle No Match

If no close match:

1. Suggest the closest partial match
2. Recommend ck-skill-creator to build a new skill
3. Suggest using ck-research to investigate the topic first

Notes

• skills_index.json is the authoritative catalog; do not modify it here
• Skill discovery queries should be fast — read index once, match in memory
• When multiple skills apply, recommend a workflow chain rather than a single skill
• New skills added via ck-skill-creator are automatically added to the index