Skillgrep

[](https://github.com/vrslev/skillgrep/actions/workflows/test.yml)

skillgrep

Search local [Agent Skill](https://agentskills.io/) collections without loading them all into every agent session.

Agents normally advertise every enabled skill's name and description, then load the selected `SKILL.md` on demand. `skillgrep` keeps infrequent private or team collections outside that catalog. One routing skill searches their metadata and resolves only the chosen file.

It does not clone, update, install, or execute registered skills.

Install

$ npx skills add vrslev/skillgrep

The skill invokes the dependency-free CLI with `uvx skillgrep`.

Configure

$ uvx skillgrep add ~/code/team-skills --name team
added  team  2

The name becomes the stable namespace in results such as `team:release-workflow`. It defaults to the directory name.

Configuration follows the XDG application convention:

${XDG_CONFIG_HOME:-~/.config}/skillgrep/config.json

There is no standard Agent Skills configuration directory. Normal setup uses `add`, `rm`, and `ls`; manual configuration is optional:

{
  "version": 1,
  "registries": {
    "personal": "~/code/personal-skills",
    "team": "~/code/team-skills"
  }
}

The file is created with mode `600` on POSIX systems. Set `SKILLGREP_CONFIG` or pass `--config` to use another location.

Example

$ uvx skillgrep q "release incident"
team:incident-release-check  Verify release state and collect incident evidence before taking action.
personal:release-notes  Draft concise release notes from a local Git history.

$ uvx skillgrep path team:incident-release-check personal:release-notes
/Users/example/code/team-skills/delivery/incident-release-check/SKILL.md
/Users/example/code/personal-skills/writing/release-notes/SKILL.md

`q` returns at most three one-line matches by default; `--top N` changes the