Skills Board

io.github.TommyBezPublished by GitHub account TommyBezv1.0.0Updated Oct 24, 2026

Search your team's shared AI-skill library, get install commands, and save skills from your agent.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

OAuth-protected remote MCP endpoint for Skills Board, letting an assistant search a team's shared AI-skill library, fetch install commands, and save skills.

What you can do
  • Search team skills and collections, and discover public or repository skills
  • Retrieve compatible install commands for a skill
  • Save new skills and organize collections when the skills:write scope is granted
  • Read the original source, copy a command, or download the latest skill files as a ZIP
When to use it
Useful when a team keeps a shared library of AI skills on Skills Board and wants agents to find, hand off, or add entries without leaving the chat. It is not needed for solo, ad-hoc skill use.
Requirements
Remote endpoint at skillsboard.sh over streamable HTTP with OAuth sign-in; the user signs in and approves scopes in the client (Settings → MCP). No environment variables or headers are declared. Writing requires the skills:write scope.
Before you install
Signing in grants the client access to organization-scoped team data; approve only the scopes you need. Saving skills writes to the shared team library. A saved skill is not a security review or pinned release, and the server reads the latest source, so inspect it before use. The tools cannot edit, delete, install, or execute skills.

Installation

In SourceWeft

  1. Open Skills Board in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.TommyBez%2Fskillsboard/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "skills-board": {
      "type": "http",
      "url": "https://www.skillsboard.sh/api/mcp"
    }
  }
}

README

[Skills Board: Your team's skills. All in one place.]

Skills Board, the agent-native skills registry for teams. Keep your team's AI skills in one place, so everyone knows where to find and use them.

[GitHub stars] [MIT license] [CI status]

Try the hosted app · Run it locally · Contribute

Why Skills Board

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

  1. Create a team library and add a skill from its GitHub repository.
  2. Skills Board keeps the original source visible and records the entry for the team.
  3. Teammates search by task, description, repository, or tag.
  4. 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.

Run locally

Prerequisites

  • Node.js 20.9 or newer
  • pnpm 10
  • PostgreSQL 15 or newer

1. Install the app

bash
git clone https://github.com/TommyBez/skillsboard.gitcd skillsboardcorepack enablepnpm installcp .env.example .env.local

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

VariableRequiredPurpose
DATABASE_URLYesPostgreSQL connection string used by the application; Neon may use the pooled URL here.
DATABASE_URL_UNPOOLEDFor migrations on NeonDirect PostgreSQL connection used by Drizzle migrations. It can match DATABASE_URL for local, non-pooled Postgres.
BETTER_AUTH_SECRETYesSecret used to sign and encrypt authentication data.
BETTER_AUTH_URLRecommendedPublic application origin; use http://localhost:3000 locally.
CRON_SECRETYes for hosted release cleanupDedicated random secret used to authenticate the daily expired collection-release cleanup configured in vercel.json.
RESEND_API_KEYYes outside developmentSends sign-in OTP and team invitation emails through Resend.
EMAIL_FROMYes outside developmentVerified Resend sender for OTP and invitation emails (e.g. Skills Board <[email protected]>).
GITHUB_TOKENNoRaises GitHub API rate limits for metadata and ZIP downloads.
VERCEL_OIDC_TOKENNoSupplied 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.

In Claude Code:

bash
/plugin marketplace add TommyBez/skillsboard/plugin install skills-board@skills-board

In any client the plugins CLI supports:

bash
npx plugins add TommyBez/skillsboard

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

LayerTechnology
ApplicationNext.js 16 App Router, React 19, TypeScript
UITailwind CSS 4, shadcn/ui, Base UI
AuthenticationBetter Auth (email OTP) with organizations and OAuth provider support
DataPostgreSQL, Drizzle ORM
EmailResend and React Email
Agent accessModel Context Protocol via mcp-handler
HostingVercel and Neon in the hosted deployment; self-hosting is supported

Project commands

CommandWhat it does
pnpm devStart the Turbopack development server.
pnpm typecheckRun the TypeScript compiler without emitting files.
pnpm testRun the unit tests (tests/*.test.mjs) with the Node.js test runner.
pnpm checkRun 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:checkCheck that the schema and committed migration snapshots match.
pnpm db:migrateApply pending migrations to the configured database.
pnpm db:pushPush the schema only to a throwaway database used for prototyping.
pnpm buildCreate a production build.
pnpm startStart the production server.
pnpm emailPreview React Email templates on port 3001.
pnpm dlx [email protected] 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.

License

Skills Board is available under the MIT License.

Source: README.md at commit 0846a0f

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts