Do I need an API key to use this skill?

No, the skill works in Keyword Search Mode by default using built-in file search. However, a Voyage API key is required to enable advanced semantic search and intelligent routing features.

How does the skill handle API rate limits?

It includes built-in rate limiting logic that batches items and implements necessary wait times to comply with Voyage 3 RPM limits, ensuring a stable indexing process.

What types of project files are indexed?

The skill scans for project-local skills (SKILL.md), agents (AGENT.md), and commands (.md files) located within the .claude and .generated directories.

When should I run the embed command?

You should run it after creating new skills or agents manually, after making significant changes to item descriptions, or to check the current embedding status of your project.

Popkit Project Embedder

Name: Popkit Project Embedder
Author: jrc1883

byjrc1883

•

Developer Tools

Computes vector embeddings for project-local skills, agents, and commands to enable intelligent semantic discovery and smart routing.

The Popkit Project Embedder is a specialized utility for Claude Code designed to bridge the gap between static local files and intelligent AI discovery. It scans your project's .claude and .generated directories to index skills, agents, and commands, allowing Claude to find tools by meaning rather than just keywords. By automating the embedding process with Voyage AI, it enables advanced features like smart routing—where Claude automatically selects the most relevant agent for a specific task based on semantic similarity—while providing a robust fallback to keyword-based search for users without an API key.

Key Features

01Semantic search for project-local skills and agents

02Selective embedding via flags for specific item types

03Detailed status reporting for project indexing health

04Automated rate-limit handling for Voyage AI API

055 GitHub stars

06Hybrid search support (Keyword + Vector embeddings)

Use Cases

01Auditing the embedding status of large local repositories

02Enabling intelligent routing to auto-select the best agent for a coding task

03Syncing manually created skills and agents for semantic discovery

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