See it in action

npx @korykaai/collab-kit init my-app

Before: empty repo, no templates, no CI, no conventions.

After: a complete collaboration baseline you own and can customize.

my-app/
├── .github/          # PR + issue templates, CI, Dependabot
├── .githooks/        # commit message hygiene
├── docs/             # maintainer playbooks (PR workflow, triage, FAQ)
├── tools/            # commit + branch validators
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
└── SECURITY.md

Quick start

Scaffold into your current repo:

npx @korykaai/collab-kit init .
git config core.hooksPath .githooks

Or into a new directory:

npx @korykaai/collab-kit init my-project
cd my-project
git init
git config core.hooksPath .githooks

Use --force to overwrite files that already exist.

Ship your release

Once your project is ready, pair collab-kit with shipkit to handle versioning, changelog, GitHub releases, and npm publish:

npx @korykaai/shipkit preflight
npx @korykaai/shipkit release --minor --dry-run
npx @korykaai/shipkit ship --patch --yes

See the shipkit repo and npm package for full command reference.

Why collab-kit?

| Approach | Setup time | You own the files | Includes docs + validators | Works offline | |----------|:----------:|:-----------------:|:--------------------------:|:-------------:| | collab-kit | ~30 sec | Yes | Yes | Yes | | GitHub "Use this template" | ~2 min | Partial (new repo only) | Rarely | No | | Husky + commitlint + manual templates | ~30 min | Yes | No | Yes | | Copy-paste from an old repo | ~15 min | Yes | Maybe | Yes |

collab-kit is for teams who want a batteries-included GitHub workflow baseline without adopting a framework or SaaS.

• No account or API key required
• No framework lock-in — plain Markdown, YAML, and shell
• Opinionated defaults you can edit or delete
• Ships maintainer docs, not just config files

What you get

| Category | Included | |----------|----------| | GitHub | PR template, bug/feature issue templates, Dependabot, CI workflow | | Git hooks | prepare-commit-msg to strip unwanted co-author trailers | | Tooling | Conventional Commits validator, branch name checker | | Docs | PR workflow, issue triage, pair programming, onboarding, FAQ | | Community | Code of conduct, contributing guide, security policy |

CLI commands

collab-kit init [dir] [--force]              # copy workflow scaffold
collab-kit validate-commit "feat: add login" # check commit message
collab-kit branch-name feat/add-login        # check branch name

Development

git clone https://github.com/kory-kaai/collab-kit.git
cd collab-kit
npm test

Documentation

• Onboarding checklist — first steps after init
• Pull request workflow
• Issue triage
• Pair programming
• Git attribution hook
• npm CI setup
• Ship releases with shipkit
• Troubleshooting

Star history

If collab-kit saved you time setting up a repo, a star helps others find it.

Contributing

PRs welcome! See CONTRIBUTING.md.

License

MIT — see LICENSE.