Skip to main content
Skillsets (/knowledge/skillsets) are BuildBetter’s organization-wide catalog of agent skills — reusable Markdown instructions that any teammate’s AI agent can find and read without cloning a repository, installing a CLI, or knowing an internal file path. A skillset is a named collection. A skill is one piece of Markdown content inside exactly one skillset.
Skillsets requires the organization-level skillsets feature flag.

​
Why It Exists

BuildBetter already tracked skills installed in connected code repositories. Skillsets solves a different problem: a marketing, GTM, support, or product teammate needs the same current instructions an engineer has, and shouldn’t need developer tooling to get them. By exposing the catalog through BuildBetter MCP, any authenticated agent — Claude, ChatGPT, Cursor, or anything else that speaks MCP — can discover and read your skills. BuildBetter serves the content; the client decides how to use it.

​
Structure

Both expose a stable UUID public_id through external APIs. Deletion is soft, so removing a catalog entry doesn’t immediately destroy history.

​
Managing the Catalog

From the Skillsets page you can:
  • Create, edit, and delete skillsets
  • Create, edit, and delete skills within a set
  • Reorder skills (move up / move down)
  • Copy a skill’s content
  • View a selected skill’s description and full rendered content
Order is not cosmetic. Agents read the catalog in the order you set, so put foundational skills before the ones that build on them.

​
Reading Skills from an Agent

Three read-only MCP tools cover discovery and retrieval: All three are annotated read-only, idempotent, and non-destructive. Two behaviors worth knowing:
  • Empty is not an error. No matches returns structured JSON with total: 0 and an empty array.
  • Cross-organization existence never leaks. A missing or inaccessible id returns a not-found style error that doesn’t reveal whether the id exists in some other organization.
MCP reads are scoped to the authenticated principal’s organization and never call external source providers live. The catalog you read is the catalog stored in BuildBetter.

​
What Skillsets Is Not

  • Not repository skills. Skillsets are a separate, organization-scoped model from skills installed in a connected code repository. The two are not unified.
  • Not synced from GitHub. External source configuration, sync, pull-request writeback, and version proposal workflows are deferred. There is no source to configure.
  • Not auto-generated. BuildBetter does not invent skills from your signals or rewrite them on its own. Changes are proposed and reviewed — see Skillset Governance.
  • Not installed into your AI client. MCP exposes the content; the client decides what to do with it.

​
Next

Skillset Governance

Access control, revision history, and reviewing proposed skill updates.

MCP Tool Reference

Every BuildBetter MCP tool, including the skill catalog tools.