Contribute
Contribute
AgentsKit is built in the open. Here's how to help — from filing an issue to shipping a new adapter.
AgentsKit is built in the open. Every package, every doc, every example — MIT-licensed and community-maintained. Your PR makes the ecosystem better for everyone.
Built in the open
Built by contributors like you
Ways to help
| If you have… | Do this |
|---|---|
| 5 minutes | ⭐ Star the repo, share the project on X/BlueSky |
| 30 minutes | File a bug, improve a doc (every page has an Edit on GitHub link), triage an issue |
| A few hours | Grab a good-first-issue, answer a discussion |
| A weekend | Ship a new adapter, tool, skill, or example; write a recipe |
| Ongoing | Become a maintainer — show up consistently, we'll hand you commit access |
Where to start
- Good-first-issues → — curated issues ready to grab
- Local setup → — clone, install, run tests
- Commit style → — conventional commits, changesets
- RFC process → — for larger proposals
- Roadmap → — what we're building next
Ground rules
- Be kind. Code reviews are about code, not people.
- Keep
@agentskit/corelean. Zero deps. Under 10KB gzipped. Types + contracts only. - Every package is plug-and-play. If your change breaks that, rethink it.
- Tests > vibes. If you change behavior, add a test.
- Docs ship with code. Public APIs need docstrings + an example.
Start a new discussion
Not sure what to work on? Pick a prompt and start the conversation. Discussions shape the roadmap.
| Topic | Starter |
|---|---|
| 🧩 Your use case | Share how you're using AgentsKit → |
| 🔌 Missing provider / tool | Propose an adapter or tool → |
| 🧪 Testing / DX friction | What's clunky? → |
| 🎨 Theming / design patterns | Share themes or component patterns → |
| 🏗️ Architecture question | Ask how something should compose → |
| 📦 New package idea | Propose a package before RFC → |
| 🧵 Migration story | Share your migration from X → |
| 🐛 Reproducible bug | File a bug with a repro → |
| ✨ Recipe request | What recipe do you wish existed? → |
| 📚 Docs gap | Point to what's confusing → |
Still undecided? Open a Q&A discussion — maintainers will help you scope something that fits your time.