AI Stack Kit is a spec-driven toolkit for installing and syncing skills, subagents, and hooks across Cursor, GitHub Copilot, and Claude. One spec.yaml per project; one sync pipeline — choose how you work:
| Guide | Best for |
|---|---|
| CLI guide | Terminal, CI/CD, scripts, aistack catalog refresh, automation |
| Extension guide | VS Code / Cursor sidebar — Modules, Catalog, Sync without a global CLI |
Product overview and install matrix: README.md. Architecture and APIs: ARCHITECTURE.md.
| File | Role |
|---|---|
spec.yaml |
What modules you use and which client receives generated files |
sources.config.yaml |
Where to discover modules (GitHub trees, npm, etc.) |
.aistack/ |
Cache, lock file, install artifacts |
Created by aistack init or AI Stack Kit: Initialize Workspace.
search → add → sync
- Discover modules (CLI
search, extension Catalog, or Skill browser). - Add rows to
spec.yaml. - Sync — resolve sources, install, write IDE-specific outputs.
client.type |
Typical outputs |
|---|---|
cursor |
.cursor/skills/, etc. |
copilot |
.github/skills/, Copilot instructions |
claude |
Claude project / user skill paths |
https://deb-adarsh.github.io/ai-stack-kit/ — browse upstream catalogs; copy npx commands. The extension globe button and Full skill browser ↗ in Catalog open this site.
For GitHub-backed catalog search, set GITHUB_TOKEN (CLI) or aiStackKit.githubToken (extension). Fine-grained PAT: Contents read on public repos.
→ CLI guide — install, command reference, env vars, troubleshooting.
→ Extension guide — Marketplace install, Activity Bar views, commands, settings.
Common pattern: extension for day-to-day add/sync; CLI in CI (aistack sync) or for catalog refresh --write.
- CONTRIBUTING.md — catalogs, PRs
- docs/CLI_UX_FLOWS.md — CLI interaction targets
- EXTENSIONS.md — custom sources and adapters
Back to README.md.