Search your team's shared AI-skill library, get install commands, and save skills from your agent.
io.github.TommyBez/skillsboard — MCP Server
This Model Context Protocol (MCP) server helps teams search a shared AI-skill library, retrieve install commands, and save skills from an agent. It is positioned for team collaboration around agent skills and AI tooling.
🛠️ Key Features
Search a team’s shared AI-skill library
Get install commands for skills
Save skills from your agent
🚀 Use Cases
Managing reusable agent skills for a team
Locating and applying install commands for AI tools
Building a shared skills repository for collaboration
⚡ Developer Benefits
Aligns with MCP (Model Context Protocol) for agent tooling
Fits into TypeScript/Next.js developer workflows
Includes topics covering mcp-server, developer-tools, and skills
⚠️ Limitations
The available details describe search, install command retrieval, and skill saving; no other capabilities are specified.
Useful skills tend to disappear into chats, bookmarks, and personal agent setups. Skills Board gives a team one searchable place to collect them and lets every teammate choose how to use them.
One team library. Save useful skills once, organize them with team-specific tags, and make them easy to find again.
Different agents welcome. Share the same entry across Claude, Codex, Cursor, and other agent setups.
A choice of handoff. Open the original source, copy a compatible install command, or download the latest skill files as a ZIP.
Organization-scoped access. Create a team, invite members, and keep each library available to its members.
Optional MCP access. Connect compatible agents to authenticated, scope-controlled tools for finding and organizing team skills and collections.
IMPORTANT
A saved skill is a team's own choice, not a security review, compatibility certification, or pinned release. Skills Board reads the latest available source; inspect that source before using it in an agent.
How it works
Create a team library and add a skill from its GitHub repository.
Skills Board keeps the original source visible and records the entry for the team.
Teammates search by task, description, repository, or tag.
Each teammate opens the source, copies a compatible command, or downloads the latest files as a ZIP.
The public catalog can help with discovery when the deployment has Vercel OIDC available. The team library and direct GitHub flow remain the core product.
Generate a Better Auth secret with openssl rand -base64 32, then add it and your PostgreSQL connection string to .env.local.
2. Prepare the database
Apply the committed Drizzle migrations to a new database. This creates both the Better Auth tables and the application-specific tables from the versioned SQL in drizzle/.
bash
pnpm db:migrate
3. Start developing
bash
pnpm dev
Open http://localhost:3000. Restart the server after changing DATABASE_URL, because the PostgreSQL pool is created when the module loads.
Environment variables
Variable
Required
Purpose
DATABASE_URL
Yes
PostgreSQL connection string used by the application; Neon may use the pooled URL here.
DATABASE_URL_UNPOOLED
For migrations on Neon
Direct PostgreSQL connection used by Drizzle migrations. It can match DATABASE_URL for local, non-pooled Postgres.
BETTER_AUTH_SECRET
Yes
Secret used to sign and encrypt authentication data.
BETTER_AUTH_URL
Recommended
Public application origin; use http://localhost:3000 locally.
CRON_SECRET
Yes for hosted release cleanup
Dedicated random secret used to authenticate the daily expired collection-release cleanup configured in vercel.json.
RESEND_API_KEY
Yes outside development
Sends sign-in OTP and team invitation emails through Resend.
EMAIL_FROM
Yes outside development
Verified Resend sender for OTP and invitation emails (e.g. Skills Board <login@your-verified-domain.com>).
GITHUB_TOKEN
No
Raises GitHub API rate limits for metadata and ZIP downloads.
VERCEL_OIDC_TOKEN
No
Supplied automatically by Vercel for the optional skills.sh catalog.
Sign-in and sign-up use email one-time codes (no passwords). Outside development, configure both RESEND_API_KEY and a domain-verified EMAIL_FROM; the fallback Resend test sender only works for Resend’s own test recipients. In development, OTP emails are skipped and any 6-digit code works. Without Vercel OIDC, the Discover catalog degrades gracefully while team libraries continue to work.
Hosted deployments run the collection-release retention cleanup once per day. Set CRON_SECRET in the Vercel Production environment before deploying; the endpoint fails closed when the secret is absent. Self-hosted deployments can invoke /api/cron/collection-release-retention from their scheduler with Authorization: Bearer <CRON_SECRET>.
MCP access
Skills Board exposes an OAuth-protected MCP endpoint at /api/mcp. After signing in, open Settings → MCP to connect it. The tools can search team skills and collections, retrieve install commands, and discover public or repository skills. With skills:write, they can save new skills and organize collections. They cannot edit or delete saved team skills, install them in an agent, or execute them.
The full contract lives at skillsboard.sh/developers (Markdown at /developers.md): the public endpoints, the OAuth flow, every tool and the scope it needs, and the versioning, error, and rate-limit conventions the HTTP surface follows. The machine-readable index of all of it is /llms.txt.
Official plugin
This repository is also the marketplace for the official Skills Board plugin. The plugin ships the MCP server configuration above and one skill that explains how to use a team library from an agent. It is not tied to one client: the directory in plugin/ carries an Agent Plugins 1.0.0 manifest, and a Claude Code manifest alongside it. Installing it is an alternative to the manual MCP setup above rather than a step after it.
Installing the plugin configures the MCP server. Connecting it still requires signing in to Skills Board and approving the requested scopes in the client.
Tech stack
Layer
Technology
Application
Next.js 16 App Router, React 19, TypeScript
UI
Tailwind CSS 4, shadcn/ui, Base UI
Authentication
Better Auth (email OTP) with organizations and OAuth provider support
Data
PostgreSQL, Drizzle ORM
Email
Resend and React Email
Agent access
Model Context Protocol via mcp-handler
Hosting
Vercel and Neon in the hosted deployment; self-hosting is supported
Project commands
Command
What it does
pnpm dev
Start the Turbopack development server.
pnpm typecheck
Run the TypeScript compiler without emitting files.
pnpm test
Run the unit tests (tests/*.test.mjs) with the Node.js test runner.
pnpm check
Run the repository's required local checks: typecheck, then the unit tests.
pnpm db:generate --name <description>
Generate a versioned migration after changing the schema.
pnpm db:check
Check that the schema and committed migration snapshots match.
pnpm db:migrate
Apply pending migrations to the configured database.
pnpm db:push
Push the schema only to a throwaway database used for prototyping.
pnpm build
Create a production build.
pnpm start
Start the production server.
pnpm email
Preview React Email templates on port 3001.
pnpm dlx shadcn@4.23.0 add <component>
Add a shadcn/ui or @remocn registry component. The shadcn CLI is not a project dependency, so it runs pinned through pnpm dlx.
Contributing
Issues and pull requests are welcome. Read CONTRIBUTING.md before making a substantial change, follow the Code of Conduct, and report vulnerabilities through the process in SECURITY.md.
See the people who have helped build Skills Board on the contributors page.