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

# Save a workflow as a Skill

> Teach Ari a process you repeat, such as a monthly board update, so it follows the same steps every time, in every workspace you work in. Save it as a Skill in chat, with Build with Ari, or by writing it yourself, limit it to one workspace when it fits only one company, give a teammate a copy or make it available to everyone in a workspace, then change or remove it later.

Save a Skill when you repeat the same process and want Ari to follow it the same way every time, such as your monthly board update or your month-end review. A Skill is a named set of instructions that belongs to you. Ari uses it on its own whenever a request of yours matches the Skill's description, in every workspace where you are a member unless you limit it to one, so you save it once. Other people in your workspaces have their own Skills, until you give one of them a copy or make a Skill available to everyone in a workspace; see [Give a teammate a copy of a Skill](#give-a-teammate-a-copy-of-a-skill) and [Make a Skill available to everyone in a workspace](#make-a-skill-available-to-everyone-in-a-workspace). For how Ari picks a Skill, see [Skills, Triggers, and Guides](https://docs.cfo.ai/concepts/automation.md).

> [tab] Ask Ari
>
> Describe the workflow, paste instructions you already use, or attach a Markdown file, and ask Ari to save it:
>
> > Every month I send the board a one-page update with cash, burn, and hiring. Save that as a Skill.
>
> > Save the attached workflow as a Skill named weekly-cash-review.
>
> After Ari finishes a piece of work you want to repeat, you can also ask:
>
> > Save what we did here as a Skill.
>
> Ari picks a name and a description if you do not give them, and saves the Skill without a separate approval step. When the steps are built on this company's own accounts, systems, people, or figures, Ari limits the Skill to this workspace; otherwise the Skill applies in all your workspaces. To choose, say so: "Save that as a Skill for this workspace only." Ari confirms the name, when the Skill applies, and where; the Skill is listed in **Settings → Skills**. A new chat has the Skill at once, and a chat already open within a message or two.

> [tab] By hand
>
> **1. Open Skills**
>
> Open the account menu, your name or picture at the bottom of the sidebar, choose **Settings**, and select **Skills**.
>
> **2. Start a Skill**
>
> Select **Write manually**. To have Ari write it with you in a chat instead, select **Build with Ari**.
>
> **3. Name the Skill**
>
> Enter a **Name**, such as `board-report`: lowercase letters, digits, and single hyphens. Spaces become hyphens as you type. You cannot change the name later.
>
> **4. Describe when it applies**
>
> In **Description**, say when Ari should use the Skill, starting with "Use when", such as "Use when the user asks for a board or investor report."
>
> **5. Write the instructions**
>
> In **Instructions**, type or paste the full workflow in Markdown: the steps, the structure of the result, and your conventions. The editor takes no file uploads, so paste a file's contents, or attach the file in a chat with Ari instead.
>
> **6. Choose where it applies**
>
> Under **Use in**, keep **All your workspaces**, or choose **Only in** this workspace for a procedure that fits only this company.
>
> **7. Save**
>
> Select **Create skill**. The Skill appears under **Your skills**, and Ari uses it in your chats wherever it applies.

## Write a description that fits

Ari reads every Skill's description on each request to decide which Skill applies. Make the description specific enough that Ari does not use the Skill for unrelated requests, and broad enough to catch the different ways people ask for the same thing:

> Use when the user asks for a board update, investor update, or monthly summary for the board, or asks to prepare board materials.

## Update or remove a Skill

Ask Ari, for example "Update the board-report Skill to include a hiring section" or "Delete the weekly-cash-review Skill." Or open **Settings → Skills**, find the Skill with **Search skills**, and:

* Select **Edit**, change the **Description**, the **Instructions**, or **Use in**, and select **Save**.
* Select **Delete** and confirm. Ari stops using the Skill wherever it applied.

A Skill of yours is yours, so a change or a deletion applies to your chats with Ari and nobody else's; a change to a workspace Skill reaches every member of that workspace except one whose own Skill has the same name, because Ari follows their version. **Settings → Skills** lists all your Skills, including ones limited to other workspaces. A Skill limited to a workspace you have left is not in use; you can still edit it, change **Use in**, or delete it. Built-in Skills cannot be edited or deleted; to change how one works for you, save your own Skill under a different name. A Skill of yours keeps its name when cfo.ai later ships an optional built-in Skill with the same name, for as long as the workspace leaves that built-in off. Once someone turns the built-in on, Ari follows the built-in in that workspace and sets your Skill aside there. Ari cannot change or delete a Skill under a built-in's name, so to keep your own version, save it again under a new name. See [Turn on a built-in Skill](https://docs.cfo.ai/guides/turn-on-built-in-skills.md).

## Give a teammate a copy of a Skill

When a teammate needs to run the same procedure, ask Ari to share your Skill with them by name:

> Share my board-report Skill with Dana Lee.

Each person you name gets their own copy, limited to this workspace, and their Settings row reads **Shared by \[your name]**. The copy is theirs from then on: they can edit or delete it, and changes to yours do not reach it. When they already have a Skill with that name, the copy takes the first free numbered name, and it counts toward their 100 Skills. Ari shares only with current members of this workspace, by their exact name or, when you can see member emails, by email; it refuses an ambiguous name, a pending invitation, or a guest, and then shares with nobody. There is no sharing control in Settings; ask Ari. A new chat of theirs has the copy at once, and a chat already open within a message or two.

## Make a Skill available to everyone in a workspace

For one procedure the whole team should follow, such as a close review every member runs the same way, make your Skill a workspace Skill. Everyone in the workspace then has it, and any member can edit or delete it.

> [tab] Ask Ari
>
> > Make my close-review Skill available to everyone in this workspace.

> [tab] By hand
>
> **1. Open Skills**
>
> Open the account menu, your name or picture at the bottom of the sidebar, choose **Settings**, and select **Skills**.
>
> **2. Choose the Skill**
>
> Under **Your skills**, find the Skill and select **Make available to everyone**. The button shows only on a Skill that applies in this workspace and whose name no workspace Skill uses yet.
>
> **3. Confirm**
>
> Read **Make \[name] available to everyone?** and select **Make available to everyone**. The Skill is listed under **Workspace skills** with **Promoted by \[your name]**.

What happens to your own copy depends on where it applied. A Skill limited to this workspace moves into **Workspace skills**. A Skill for all your workspaces stays yours everywhere, and in this workspace Ari keeps following your personal version while both have the same name; your row says so, and other members follow the workspace version. A workspace can hold 100 shared Skills, and a workspace Skill cannot take a built-in Skill's name. Every member's new chat has the Skill at once, and a chat already open within a message or two. See [Settings](https://docs.cfo.ai/reference/settings.md#workspace-skills) for every label and message.

## Share a fact with your team

A Skill holds your own process. A fact everyone at a company should share, such as how the company defines bookings or when its fiscal year starts, belongs in workspace memory, which applies to every chat for everyone in that workspace. Ask Ari: "Remember for the whole workspace that bookings count signed contracts." See [What Ari remembers](https://docs.cfo.ai/concepts/ari-memory.md).

## Start from a sample

[Sample Skills](https://docs.cfo.ai/reference/sample-skills.md) has four complete Skills, such as a three-statement buildout and a headcount plan built from capacity, that you can save as they are or adapt.

## If something goes wrong

Settings explains why a Skill was not saved, for example when the name is already taken or the instructions are too long. For every message and limit, see [Settings](https://docs.cfo.ai/reference/settings.md#skills) and [Limits](https://docs.cfo.ai/reference/limits.md#skills-triggers-and-guides).

## Related

* [Turn on a built-in Skill](https://docs.cfo.ai/guides/turn-on-built-in-skills.md)
* [Schedule a report or a reminder with a Trigger](https://docs.cfo.ai/guides/schedule-a-trigger.md)
* [Teach Ari your company's conventions](https://docs.cfo.ai/guides/teach-ari.md)
* [Skills, Triggers, and Guides](https://docs.cfo.ai/concepts/automation.md)


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