Why do I need to embed my project items?

Embedding allows Claude to understand the conceptual meaning of your skills and agents, enabling it to find them via natural language search even if you don't use exact keywords.

What happens if I use this skill on the Free tier?

Free tier users receive a fallback implementation that provides basic grep-based file search commands to find local skills and agents manually.

What is the benefit of smart routing?

Smart routing uses these embeddings to automatically select the best-suited agent or skill for a specific user prompt, reducing the need for manual command invocation.

Can I selectively update my embeddings?

Yes, the skill supports flags like --type to filter by specific item categories and --force to re-index items regardless of their change status.

Do I need an external API key for this skill?

Yes, this skill requires a VOYAGE_API_KEY environment variable to generate the vector embeddings used for semantic discovery.

Project Semantic Embedder

Name: Project Semantic Embedder
Author: jrc1883

byjrc1883

0•

Data Science & ML

Generates vector embeddings for project-local skills and agents to enable intelligent semantic search and smart routing within Claude Code.

The Project Semantic Embedder is a professional-grade utility designed to enhance Claude Code's discovery capabilities by indexing your custom skills, agents, and commands into a vector database. By computing semantic embeddings via the Voyage API, this skill enables features like smart routing—where Claude automatically selects the most relevant agent for a task—and natural language searching that goes beyond simple keyword matching. It manages the complexities of batch processing, rate limiting, and status reporting, ensuring your local AI workflow remains organized and searchable by meaning rather than just syntax.

Key Features

01Vector indexing for skills, agents, and commands

02Detailed status reporting for embedding coverage and staleness

03Automated rate limit handling and batch processing

04Intelligent smart routing to auto-select best-fit agents

05Semantic search discovery by meaning rather than keywords

060 GitHub stars

Use Cases

01Enabling Claude to automatically select the correct agent for complex multi-step tasks

02Searching through large libraries of custom commands using natural language queries

03Keeping local automation scripts and documentation synchronized with a semantic index

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jrc1883/popkit-claude pop-embed-project

For use in Claude.ai and ChatGPT

Download Skill