Agent Facets

A facet packages the text that shapes how an AI assistant behaves: domain-specific instructions (skills), specialized agent configurations (agents), and custom slash commands (commands). Facets can also reference MCP servers — code that gives the assistant new tool capabilities — without bundling the server code itself.

facet is a package manager for facets — modular, versioned bundles of skills, agents, commands, and MCP server references that extend AI coding assistants.

Install the CLI

curl

curl -fsSL https://agentfacets.io/install | bash

Verify the install:

facet --version

Once installed, update in place with facet self-update.

Quick example

Install an adapter for your AI tool, then add a facet:

# Pick an adapter (opencode, claude-code, or codex)
facet adapter install

# Add a facet from the registry
facet add cowsay

That’s it. The facet’s skills, agents, and commands are now available in your AI coding tool.

Guides

Install Facets

Set up an adapter, search the registry, add facets, and manage your project.

Create Your First Facet

Scaffold a project, write skills, agents, and commands, then build a .facet archive.

Publish a Facet

Sign in to the registry, build, publish, and handle drift detection.