Skip to main content
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 -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.