skills-kit

Open-source monorepo for @skills-kit/cli — the repo-local skill switchboard for AI agents.

---

This is the official repository for Skills Kit, a local-first developer tool for managing AI agent skills (MCP tools or abilities).

Monorepo Packages

• @skills-kit/cli — The core CLI tool and interactive terminal switchboard.

---

Local Development

Ensure you have pnpm installed, then run:

pnpm install     # Install workspace dependencies
pnpm test        # Run all test suites
pnpm build       # Build all packages
pnpm quality     # Run full quality gate (lint, build, test, smoke test)

The package is local-first: it reads source skills from ./.agents/skills, writes metadata under ./.agents/skills-kit, and manages only repo-local harness symlinks it owns. See packages/cli/SAFETY_MODEL.md for the file-change contract.

---

Release Process

CI runs on every pull request and every push to main or dev. Npm publishing runs only from v*.*.* tags or a manual workflow dispatch.

Git Branching Model

• main is the protected release branch.
• dev is the protected integration branch for grouped work.
• Feature branches should target PRs to dev or main.
• Releases are triggered by publishing immutable semver tags (e.g. v1.0.2) from main.

git tag v1.0.2
git push origin v1.0.2

---

License

Apache-2.0. Maintained by Jalil Laaraichi (@reachjalil).