Skills / Agents / MCP for Bun ORM

[Sik819]

Requesting to start a community effort to add an agent-friendly “skills” package for Bun ORM, similar to how Supabase publishes AGENTS.md, SKILL.md, and a references/ corpus for high-quality, repeatable best practices. SupaBase Skills

Why?

• Consistency: while bun is powerful, it is hard to maintain consistency as I notice the codebase drift into mixed patterns (query style, migrations, transactions).
• Faster onboarding: As new devs (and now AI assistants) can follow one playbook instead of rediscovering conventions.
• Fewer production footguns: Clear defaults for performance (eg indexes), security (eg SQL injection), and correctness

Example implementation

Folder structure

• AGENTS.md — repo/codebase guidance (how to use Bun)
• SKILL.md — task focused skills with examples + acceptance checks
• references/ — curated docs, examples, benchmark notes, pitfalls, links

What to include

AGENTS.md / Claude.md (how to work in this codebase)

• Project conventions: repo layout, naming, error handling, context usage
• Bun patterns: models, hooks, NewSelect/NewInsert, scanning, relations
• Migration workflow + environment setup
• Testing approach

SKILL.md (repeatable skills - or best practices)

• CRUD with Bun
• Transactions + isolation levels + retries
• Pagination
• Relations / joins
• Performance playbook (eg - indexes, EXPLAIN, query shaping)
• Security basics (eg - parameterization, least privileged)

references/

• References to be used in SKILL.md
• Official Bun docs + best examples
• best practice queries and anti-patterns
• Migration templates, index recipes, perf notes

MCP server ideas (optional)

A small read-only or local-only MCP to help agents:

• search_docs (Bun + SQL conventions)
• inspect_schema (tables, indexes, constraints)
• explain_query (run EXPLAIN (ANALYZE, BUFFERS) locally)
• list_models (discover Bun models + tags)
• migration_helper (generate/check migration skeletons)
• examples: Angular dev MCPs

Contributors

I need help from contributors who are comfortable with SQL/Bun and I can help draft:

1. AGENTS.md outline
2. Best practices and skills to be used in SKILL.md
3. a minimal MCP tool list

If you’re in, let me know with which piece you want to take (AGENTS / SKILL / MCP) and any best practices you’ve learned the hard way

[vmihailenco]

IMHO, curated documentation would have the most impact if it supported llmstxt.org. To do that properly, we’ll likely need to rework the current docs at https://bun.uptrace.dev/
.