Local Agent Skills router

Helps your coding AI use your skills folders on this computer. No cloud marketplace required.

How it works when you switch repos: the catalog holds all skills; Local Agent Skills router (kit) picks and installs the right set into each project.

You do not copy the whole catalog into every repo. The router keeps the catalog in place and deploys a small copy per project.

Who it is for: people who keep Agent Skills (folders with a SKILL.md file) on a laptop or team drive, and want a project to get the right ones in a few commands.

Who it is not for: people who only want to download skills from the public internet (use skills.sh for that). Skill files still follow the open Agent Skills format.

License: MIT. This folder is only the tool. Your skills stay in a separate catalog folder.

---

What you get

1. A kit command that lists, recommends, and installs skills into a project.
2. A clear split: catalog = source of truth; project = small deploy copy for the IDE.
3. Files agents can read (AGENTS.md, SKILL.md) so an AI in your IDE can run kit for you.

---

First-time setup (pick your window)

Windows Command Prompt (cmd)

cd path\to\offline-kit-router
powershell -ExecutionPolicy Bypass -File install-shim.ps1
kit init %USERPROFILE%\my-skills-catalog
set KIT_ROOT=%USERPROFILE%\my-skills-catalog

Make KIT_ROOT permanent (opens new windows only):

setx KIT_ROOT %USERPROFILE%\my-skills-catalog

Windows PowerShell

cd path\to\offline-kit-router
.\install-shim.ps1
kit init ~/my-skills-catalog
$env:KIT_ROOT = "$HOME\my-skills-catalog"
[Environment]::SetEnvironmentVariable("KIT_ROOT", "$HOME\my-skills-catalog", "User")

macOS / Linux

Needs PowerShell 7+ as pwsh:

cd path/to/offline-kit-router
bash install-shim.sh
./kit init ~/my-skills-catalog
export KIT_ROOT=~/my-skills-catalog

---

Use it on a project

Think of two folders:

Folder	Everyday meaning
Your app	The product you are building (can stay private)
Your skills catalog	Where you keep reusable Agent Skills (can stay private)

This tool can be public. Your app and catalog do not have to be.

1. Open a terminal inside your app.
2. Point KIT_ROOT at your skills catalog (not at the app itself).

cmd:

cd path\to\your-app
set KIT_ROOT=path\to\your-skills-catalog
kit where
kit rec
kit apply --profile
kit ignore-snippet

PowerShell:

cd path\to\your-app
$env:KIT_ROOT = "path\to\your-skills-catalog"
kit where
kit rec
kit apply --profile

1. Confirm skills landed under .cursor/skills (that is today’s default install target for Cursor-shaped layouts).
2. In the IDE chat, ask the agent to use one of those skill names.

Optional: create .kitroot in the app (first non-comment line = path to the catalog) so you can skip set KIT_ROOT in that folder.

Claude Code / Codex note: you can still run kit rec and kit commands. kit apply currently writes Cursor-style .cursor/ folders. Use kit discover to see where your IDE keeps skills, then copy or point as needed until a dedicated target lands.

---

Ask your AI to do it

Read AGENTS.md in the offline-kit-router folder if needed.
For this project: run kit where, then kit rec, show me must vs add-ons,
then run kit apply --profile only if I say yes.
Do not copy the whole catalog into git. Prefer gitignore for .cursor/skills.

---

Commands (short)

Command	Meaning
kit where	Show which catalog is active
kit list / kit find …	Browse skills
kit rec	Suggest must + add-ons for this folder
kit apply / kit apply --profile	Install into .cursor/ (Cursor-shaped)
kit init [dir]	New empty catalog
kit discover	Known IDE skill folders on this PC
kit ignore-snippet	Lines for .gitignore
kit sync	Refresh install after catalog changes
kit personal	Install into your user Cursor skills
kit link	Put kit on PATH

---

Two folders (do not mix)

Folder	Role
This router	The kit tool (can be public)
Catalog (KIT_ROOT)	Your skills (often private)

Team sharing: put the catalog on a private git remote. Each person clones it, sets KIT_ROOT, runs kit sync.

---

For developers

• Windows entry: kit.cmd → kit.ps1
• Unix entry: kit → pwsh → kit.ps1
• Installer: install-kit.ps1
• Templates: templates/catalog, templates/project.gitignore.snippet
• Agent rules: AGENTS.md

---

What this is not

• Not a replacement for agentskills.io (the format).
• Not your private company playbooks (those stay in the catalog).
• Not a scan of your entire hard drive (kit discover only checks known IDE folders).
• Not a full multi-IDE installer yet (kit apply is Cursor-shaped today).