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

# Plugins and Admin controls

> Read what a plugin contains, turn its skills on, and choose what your Organisation offers.

A plugin brings together skills, their files and the connectors they use. Read it before you turn it on, then use its skills from the Beacon composer.

> [!NOTE]
>
> Everyone with a Platform seat can use available plugins; Organisation Admins manage sources and choose what the Organisation offers.

## Read a plugin

Open **Settings > Skills**, under **Customise**, and choose a plugin in **Yours** or **Discover**.

| Tab | What you can check |
| - | - |
| **Overview** | Who made it, its description, version and what your Organisation offers. |
| **Contents** | Its files, with **View** and **Code**, earlier versions and **Export this version** to download a ZIP. |
| **Skills** | Each skill’s command, description and **How it runs**: only when named, or also when Beacon chooses it for a matching request. |
| **Connectors** | The systems it uses, their connection state and **Connect** where available. |

A plugin carries no sign-in of its own. Connect a system through your own account. See [Connectors](https://docs.saphion.co.uk/beacon/connectors.md).

## Turn a plugin on

Use its switch, or **+** on its Discover card. Its skills then appear when you type `/` in Beacon. **Try in chat** opens a new chat with a skill selected and nothing sent. A required plugin has no switch to turn it off.

## Choose what members get

As an Admin, open the plugin’s **Overview** and find **For your Organisation > Availability**.

| Choice | What members get |
| - | - |
| **Not available** | Hidden from members; Admins can still open it. Offered for plugins the Organisation brought in. |
| **Available** | Members can find it in Discover and choose to turn it on. |
| **On by default** | On until a member chooses to turn it off. |
| **Required** | On for every member and cannot be turned off. |

Saphion plugins start on until an Admin changes their offer. A plugin brought in from a marketplace source starts **Not available** until an Admin offers it. If another Admin changes the offer while you are editing, Saphion reads it again instead of overwriting their choice.

## Bring in a source

**1. Add the repository**

In **Settings > Skills**, choose **Add > Add marketplace source**. Enter a public GitHub repository in the Claude plugin format, with a `.claude-plugin/marketplace.json`. Private repositories cannot be read. An Organisation can keep up to 20 sources.

**2. Read it**

Choose **Sync now**. The report lists what was added and what was refused, with the reason. Adding the address alone does not sync it.

**3. Offer a plugin**

Open an accepted plugin from the report and set its **Availability**. Members can use it only as that offer allows.

Sync again to read updates. A changed plugin gets a new version; an unchanged one stays as it is. **Remove** on the source’s menu stops reading that repository.

## How it works

A skill gives Beacon a procedure. It grants no extra access: Saphion checks your permissions for every act. Connector tools keep their own approval settings, and a plugin cannot bypass them. See [Shared and Organisation skills](https://docs.saphion.co.uk/beacon/shared-skills.md) for command clashes and who may edit or remove a skill.

## Ask Beacon

“Help me make a skill for our weekly Project update, using this report as the example.” Review and try the skill before relying on it for repeated work.

## FAQ

> [accordion] Why can I see a plugin but not its slash command?
>
> Only skills in plugins that are on appear in the composer. Check the plugin’s switch and your Organisation’s offer.

> [accordion] Does adding a source make everything available to members?
>
> No. Sync reads its plugins; an Admin then chooses which ones to offer.

## Related

* [Skills](https://docs.saphion.co.uk/beacon/skills.md): Run a skill or write your own.
* [Shared and Organisation skills](https://docs.saphion.co.uk/beacon/shared-skills.md): Access, commands and removal.
* [Connectors](https://docs.saphion.co.uk/beacon/connectors.md): Connect accounts and control their tools.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.