> ## Documentation Index > Fetch the complete documentation index at: https://docs.connie.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create and share skills > Write your own skill for Connie, add reference files and tools, copy a built-in skill, share a read-only link, or delete a skill. You can write your own [skills](/skills/overview) — playbooks that tell Connie exactly how your team does a task. A skill is written in plain text (markdown) in a file called **SKILL.md**, and can include extra files Connie reads alongside it, like a tone guide or a price list. **Where:** left sidebar → **Skills** → **Add skill** · `https://connie.ai//skills` Any workspace member can create, edit, duplicate, share and delete the workspace's skills. ## Create a skill Left sidebar → **Skills** → **Add skill** (top right). The **New Skill** page opens. **Back to Skills** leaves without saving. Fill in **Skill name** and **Description**. The description is how Connie decides when your skill fits a request, so say *when* to use it — for example "Use when I ask to sort or clean up my inbox". If you leave it empty, the first line of the instructions is used. In the **SKILL.md** editor, write what Connie should do, step by step, in plain language. Headings and lists help. For example: ```markdown theme={null} ## Overview Sort my unread inbox conversations. ## Steps 1. Read unread conversations from the last 2 days. 2. Group them into Reply now, Snooze and Archive. 3. Show me the plan before changing anything. ``` Click **+ Add file** to add another text file to the skill, and give it a path such as `examples/good-replies.md`. Each file needs a unique path that isn't `SKILL.md`. Click **Create skill**. Connie sets the command from the name (a skill named "Email Triage" gets `/email-triage`), sets it to **Auto**, and files it under **General**. You can change the command and mode with **Edit**. ## Edit a skill Open the skill → **Edit**, or click **⋮** on its card → **Edit**. You can change: | Field | What it's for | | - | - | | **Name** | The skill's display name. | | **Command** | What you type after `/` to run it. 2–64 characters: lowercase letters, numbers and hyphens. Must be unique in the workspace. | | **Description** | "One line Connie uses to know when this skill applies." Connie matches your requests against this, so make it specific about when to use the skill. | | **Instructions** | The SKILL.md text. **Improve with AI** rewrites it to be clearer (**Improving…**). Check the result before saving. | | **When can Connie use it?** | **Auto** ("Command + auto-discovery when relevant") or **Command only** (runs only via its `/command`). | | **Context files** | Reference files loaded with the skill. See below. | | **Tools this skill uses** | Tools the skill needs. See below. | Click **Save** (**Saving…**), or **Cancel** to discard changes. ### Add context files Context files give Connie extra material every time the skill runs — examples, templates, a product sheet, a screenshot. 1. In **Edit**, under **Context files**, click **Add file**. 2. Pick one or more files from your computer. 3. Watch the token meter ("\~X / 25,000 tokens") — it shows how much of the skill's file budget you've used. Remove a file with its delete button. Accepted files: text (md, txt, csv, tsv, json, yaml, xml, html, and code such as js, ts, py, sql), Word and Excel (converted to text on upload), images (png, jpg, gif, webp), PDF, and video (mp4, webm, mov — attached for playback). ### Choose the tools a skill uses Under **Tools this skill uses**, search with "Search tools to bind…" and tick the tools the skill needs. They're "Shown as Permissions on the skill, and pre-loaded when the command runs. Optional." Connie can still use other tools when needed, and every tool keeps its [permission](/tools/permissions) — a skill never skips an approval. ## Copy a built-in skill (Duplicate) Built-in skills can't be edited. To customise one, make your own copy: 1. Open the skill and click **Duplicate** (or **⋮** → **Duplicate** on one of your own skills). 2. Connie creates a copy named after the original with "(copy)" at the end, and a command ending in `-copy`, and opens it in edit mode ("Copied to ... — editable here."). 3. Change what you need and click **Save**. You can also save a built-in skill from a tool's **Skills** tab with the save icon ("Saved to My Skills"). See [Tools](/tools/overview). ## Share a skill Everyone in your workspace can already use every workspace skill — sharing is for people **outside** the workspace, and it's read-only. Open the skill → **Share**, or **⋮** on its card → **Share**. The window reads "Publish a read-only page anyone with the link can open". Change external access from **Invited people only** to **Anyone with the link**. "People will be able to read SKILL.md and its permissions, but never run or edit the skill". Click **Copy link** and send it. You'll see "Sharing updated". To stop sharing, switch back to **Invited people only** — the public link stops working straight away. Without a public link, **Copy link** copies the skill's in-app address, which only members of your workspace can open. You can't limit a skill to certain members: "Skills belong to the workspace — everyone in it can already use this one, so access can't be narrowed to selected members". Built-in skills can't be shared. ## Delete a skill 1. On the **Skills** page, click **⋮** on the skill's card → **Delete**. 2. Confirm in **Delete skill** ("Deleting will permanently erase all the data of ..."). Deleting is permanent and can't be undone. Links to the skill stop working. Built-in skills can't be deleted. ## Limits | What | Limit | | - | - | | Name | 100 characters | | Description | 500 characters | | Instructions (SKILL.md) | 20,000 characters | | Command | 2–64 characters; lowercase letters, numbers, hyphens; starts with a letter or number; unique in the workspace | | Context files | Up to 20 files, 25,000 tokens in total | | Size per file | Text 200 KB · images 3 MB · PDF 4 MB · video 3 MB · Word/Excel 10 MB (before conversion to text) | ## Good to know * Any workspace member can create, edit, share, duplicate and delete workspace skills — not just admins. Edits apply for everyone straight away. * New skills you create appear under **My Skills** and the **General** category. * A shared skill page shows the instructions and the tools it uses. Viewers can't run or edit it. ## Troubleshooting **Why:** another skill in the workspace already uses that command. **Fix:** open **Edit** and choose a different **Command**. **Why:** two extra files have the same path, or one is named `SKILL.md`. **Fix:** rename the file paths so each is different. **Why:** the file type isn't supported, it's over the size limit, or the skill's 25,000-token file budget is used up. **Fix:** use a supported format, trim or split the file, or remove files you don't need. See [Limits](#limits). **Why:** the link couldn't be created. **Fix:** try again. If it keeps failing, email [support@connie.ai](mailto:support@connie.ai). **Why:** the link was turned off, the skill was deleted, or the link was copied incompletely (you may see "...is missing its access token."). **Fix:** ask the person who shared it for a fresh link. **Why:** the skill is **Command only**, or the description is too general. **Fix:** set **When can Connie use it?** to **Auto** and make the **Description** say exactly when to use it. ## Related * [Skills](/skills/overview) — what skills are and how to run them * [Tools](/tools/overview) — tools a skill can use * [Tool permissions](/tools/permissions) — approvals still apply inside skills * [Chat](/chat/overview) — run a skill with / This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.