# Facet Inserts

> Save and reuse prompts, commands, and shortcuts across all your gems.

## What Are Facet Inserts?

Facet Inserts are saved prompts that live inside your Crystl configuration. Each insert has a **label** (what you see in the menu) and a **body** (the text that gets sent to your agent). Instead of retyping the same instructions, you fire them with one click from any shard.

## Insert Types

Facet Inserts support three types:

- **Prompt** — Natural-language instructions sent to your agent, like "fix this bug" or "write tests for this file"
- **Command** — Slash commands or CLI invocations that run directly
- **Shortcut** — Quick actions for common workflows like committing, rebasing, or running tests

## Adding a Facet Insert

1. Open **Gem Settings** from the status bar in any shard
2. Navigate to the **Facet Inserts** section
3. Click **Add Insert**
4. Enter a label and the prompt body
5. Choose a type (prompt, command, or shortcut)
6. Optionally assign a category to keep things organized

The insert is available immediately across all your shards.

## Using Facet Inserts

Open the Facet Insert menu from the shard toolbar. Your inserts are grouped by category. Click any insert to send it directly to the active shard.

## Organizing by Category

Assign categories to group related inserts — by task type (debug, refactor, test), by project convention, or however fits your workflow. Categories keep the menu clean as your library grows.

## Prompt Library Integration

Guild members get access to the [Prompt Library](/prompts) — 200 ready-made prompts organized across 20 categories including debugging, code review, git workflows, testing, API design, and more. Browse the library, find prompts that fit your workflow, and add them directly to your Facet Inserts.

## Free vs Guild

| | Free | Guild |
|---|---|---|
| Facet Inserts | Up to 5 | Unlimited |
| Prompt Library | — | Full access |

The free plan gives you 5 Facet Inserts to save your most-used prompts. Guild members get unlimited inserts and full Prompt Library integration.

## Shared Across Gems

Facet Inserts are stored in your Crystl configuration, not tied to a single gem. The same library is available in every project you open.

---
Source: https://crystl.dev/docs/facet-inserts/