> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modules

> Install starter kits (bundles of AI agents, commands, and rules) into your workspace in one click.

## Overview

Modules are curated **starter kits** for the Custral assistant (⌘I). Each module
bundles ready-made **agents**, **commands** (skills you run with a `/trigger`),
and **rules** for a job to be done, so you can go from an empty assistant to a
useful one in a click instead of writing each piece by hand. Install a whole kit,
or add just the pieces you want.

## How it works

* A **module** is a bundle of Chat Agents + commands + rules. Custral ships a set
  of them: **Product Team**, **Retail & Grocery Ops**, **Sales SDR**, **Support
  Triage**, and **Recruiting**.
* **Installing copies the items into your workspace** as ordinary, editable rows.
  It's a copy, not a live link. Your edits stay yours and don't change the
  catalog, and a catalog update never overwrites what you've changed.
* **Installing is safe to repeat.** Re-installing a module, or adding a piece you
  already have, never creates duplicates.
* Once installed, agents appear in the assistant's **agent picker**, commands show
  up when you type <kbd>/</kbd> in the composer, and rules apply on every run. You
  manage or remove them like anything else in [Chat
  Agents](/ai/chat-agents/overview) and [Rules & Skills](/ai/rules-and-skills).
* **Modules vs. [Packs](/ai/provider-tools):** a module is *copied in* and fully
  editable; a pack *lights up automatically* only while its provider is connected
  and is read-only. Use a module for a starting point you'll shape; a pack for a
  connected tool's built-in helpers.

## Using it

<Steps>
  <Step title="Open Settings → AI → Modules">
    The catalog opens on the **Modules** tab. The **Agents**, **Commands**, and
    **Rules** tabs browse the same catalog one item at a time, and **Packs** shows
    the read-only provider packs.
  </Step>

  <Step title="Browse a kit">
    Click a module card. The panel on the right lists everything it ships, its
    agents, commands, and rules.
  </Step>

  <Step title="Install the kit, or add pieces">
    Choose **Install module** to add the whole kit, or **Add** next to a single
    agent, command, or rule to bring in just that piece.
  </Step>

  <Step title="Use and edit it">
    Pick an installed agent in the assistant (⌘I), or type <kbd>/</kbd> to run an
    installed command. Edit or remove any installed item in **Agents** and **Rules
    & Skills**. Your changes never affect the catalog.
  </Step>
</Steps>

## Troubleshooting

| Symptom                                                  | Likely cause                              | What to check                                                                                                                                                                     |
| -------------------------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A module still shows **Install** after I installed it    | The installed item was renamed            | Installed items are matched by name. If you renamed an installed agent, command, or rule, the catalog no longer counts it as installed. Your copy is independent and still works. |
| The **Install** button is disabled and I can't install   | You don't have permission                 | Installing adds workspace-wide agents, commands, and rules, so it needs an **Admin** role. Anyone can browse the catalog.                                                         |
| An installed **command** doesn't appear in the assistant | The skill is disabled or lost its trigger | In **Rules & Skills → Skills**, confirm the skill is **Enabled** and still has its `/trigger`.                                                                                    |
| An installed **agent** or **rule** isn't taking effect   | The item is disabled                      | Open it in **Agents** / **Rules & Skills** and confirm it's enabled; a rule scoped to an object or page only applies when that context is present.                                |

<Note>
  If installing fails, include the request id from the error toast when reporting
  it. It links the in-app error to the server logs.
</Note>

## Related

* [Rules & Skills](/ai/rules-and-skills): where installed commands and rules land,
  and where you edit them.
* [Chat Agents](/ai/chat-agents/overview): where installed agents land.
* [Provider Tools](/ai/provider-tools): the read-only **packs** connected
  providers contribute (the other tab alongside Modules).
* [AI Overview](/ai/overview)


## Related topics

- [Retrieve a usage module](/api-reference/usage-modules/retrieve-a-usage-module.md)
- [List usage modules](/api-reference/usage-modules/list-usage-modules.md)
- [The Usage module object](/dev/api-reference/usage-modules.md)
- [Create a usage module](/api-reference/usage-modules/create-a-usage-module.md)
- [Navigation Overview](/surfaces/navigation/overview.md)