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

# Use skills

> Get answers done the way your team does the job — with the skills Jinn ships, and your own when you need more.

> [!NOTE]
>
> Anyone in the workspace can use every skill. Only workspace admins can add, edit and delete
> custom skills. If **New skill** and **Edit** are missing, you're looking at skills somebody
> else looks after.

A skill is a piece of know-how written down once: how to run a discovery call, what goes into
a product spec, how a follow-up email to a client should read. Ask the
[chat](https://docs.jinn.so/find/ask-a-question.md) for one of those jobs and it does it the way the skill says,
instead of making it up each time.

You don't have to write any of this yourself. Jinn ships a set of skills for the jobs most
teams share, and they work from the first chat. Custom skills are for when your team does a
job its own way, or does a job none of them covers.

![The Skills page in Jinn: the All, Workspace and Built-in tabs, a search box and sorting, and a list of skills, most of them marked Built-in](https://mintcdn.com/jinn/48W-8QqP6SyFhGB7/images/skills/skills-list.png?fit=max\&auto=format\&n=48W-8QqP6SyFhGB7\&q=85\&s=f9b118704d55af80bb5d3ae7b6bb55a7)

The Skills list, with the built-in skills Jinn ships

## The skills you already have

Open **Skills** in the left sidebar. Every workspace starts with fifteen skills marked
**Built-in**:

| Area | Skills |
| - | - |
| Sales | Discovery call, Objection handling, Cold outreach |
| Recruiting | Job description, Candidate screening, Interview kit |
| Product | PRD writing, Sprint planning, Retrospective |
| Teams | Standup summary, Weekly team brief |
| After meetings | Meeting notes, Meeting follow-up |
| Knowledge | Knowledge capture, Research brief |

Nobody has to set them up or switch them on. Open one to read what it asks for — its steps,
its rules and what a good result looks like — so you know what you'll get before you use it.
Nobody can change or delete a built-in skill, admins included. They're the baseline every
workspace can rely on.

So the question is rarely how to get a skill working — it's which job your team keeps
explaining to the chat from scratch.

> [!TIP]
>
> Use the built-in skills on real work first and read what comes back. When you find yourself correcting the same thing in every answer — the tone of a follow-up, a section your specs always have — that’s the custom skill worth writing, and you’ll know exactly what to put in it.

## Use a skill in a chat

You don't have to do anything. The chat knows every skill's name and description, and when a
question fits one it loads the skill before answering. Ask *draft the follow-up for today's
call with the payment provider* and it reaches for **Meeting follow-up** skill by itself.

To make sure a particular skill is used, pick it yourself. Type **/** in the message box and
choose from the list: your team's own under **Custom skills**, the ones Jinn ships under
**Built-in skills**. Hover over one to see what it's for. Or open **+** in the message box and
then **Skills**. Or click **What Jinn can do** in the message box, open the **Skills** tab and
click the skill.

![The / menu in Jinn's message box, with Custom skills at the top and Built-in skills below: Candidate screening, Cold outreach, Discovery call and others](https://mintcdn.com/jinn/48W-8QqP6SyFhGB7/images/skills/use-a-skill.png?fit=max\&auto=format\&n=48W-8QqP6SyFhGB7\&q=85\&s=7aa38a05e9fcea5507398259d37aaf98)

Type / to pick a skill

The skill sits in your message as a chip, and Backspace removes it whole. A message can carry
up to five. A skill you pick applies to that message only, so pick it again for a follow-up
that needs it too.

![A chat in Jinn where the message starts with the Meeting follow-up chip; the reply is a follow-up email with the decisions, next steps and action items, citing the recordings it found](https://mintcdn.com/jinn/48W-8QqP6SyFhGB7/images/skills/skills-in-chat.png?fit=max\&auto=format\&n=48W-8QqP6SyFhGB7\&q=85\&s=b5d307f5af90b45eb1e80b1d8dcdd33f)

Meeting follow-up, picked by hand, writing from the call's recordings

## Add a custom skill

When a built-in skill is close but your team does the job differently, or no skill covers it
at all, write your own.

1. Open **Skills** and click **New skill** (**+** at the top of the list). Jinn creates a skill
   called *New skill* and opens it straight away — there's no form to fill in first.
2. Click the name in the window's top bar and type the real one. Name it after the job, the way
   people will look for it when they type **/**: *Client follow-up*, not *Sales process v2*.
3. Fill in **Description**: what the skill is for and when to use it, in one line. The chat
   reads this to decide whether the skill fits a question, and it sees roughly the first 150
   characters, so put what matters there.
4. Click **Edit** on the main text, write the instructions in plain markdown — the steps, the
   order, the rules, what a good result looks like — then click **Done** to see it formatted.
5. Click **Save**.

> [!TIP]
>
> For example, a description: *Turns a customer call into a follow-up email: what we heard,
> what we promised, and the next step with a date. Use after any call with a client.* And the
> main text: *Open with one line on why we met. Then three short sections: what we heard, what
> we promised and by when, and the single next step with its date. Never promise a date nobody
> said on the call. Keep it under 200 words.*

The bar shows **Unsaved changes** until you save. If you try to leave with words that aren't
saved, Jinn asks first — **Keep writing** or **Discard** — so nothing goes by accident.

To give the skill an icon or an emoji, click **Add icon** beside its name. Without one it shows
a lightning bolt.

A built-in skill can't be copied. If one is nearly right, open it beside your new skill and
write yours along the same lines, changing what your team does differently.

### Add files and folders

A skill can carry reference material besides its main text: a template, a checklist, examples
of the real thing. Use **Add file** or **Add folder** from the **⋯** menu in the skill's bar,
or from its tree. A new file opens ready to type, and it needs a name before it can save.

Keep each file to one thing — one template, one checklist, one example. The chat opens a file
only when it needs it, by name, so a skill can carry a lot without slowing every answer down.
Very long files are cut short when the chat reads them, and the chat is told so.

### Create a skill from the chat

You can also describe the job to the [chat](https://docs.jinn.so/find/create-with-the-chat.md#create-an-agent-a-skill-or-a-doc)
and let Jinn write the skill. It drafts a name, an emoji icon, a description and the main text,
and opens them in **Skill preview**, where you can edit anything and pick another icon. Nothing
is created until you click **Save**, and asking the chat for a change gives you a new version
of the draft.

## Keep the list tidy

The tabs at the top of **Skills** keep the two kinds apart: **All**, **Workspace** for your
team's own, and **Built-in**. The list has search and sorting — **Last updated**,
**Newest first** and **By name**. **Share** in a skill's window copies its link, for pointing a
colleague at it.

![The Skills list in Jinn with the All, Workspace and Built-in tabs, the search box, and the sort menu open on Last updated, Newest first and By name](https://mintcdn.com/jinn/48W-8QqP6SyFhGB7/images/skills/skills-list-sort.png?fit=max\&auto=format\&n=48W-8QqP6SyFhGB7\&q=85\&s=cde6bf6857be5c6be3455e0f0a9a81ad)

The tabs, search and sorting on the Skills list

A workspace holds up to 100 skills. At the limit, Jinn says so, and you'll need to delete one
to make room.

To delete a custom skill, open **More** (**⋯**) on its row, or the **⋯** menu in its window, and
choose **Delete**.

## Skills and agents

A skill isn't tied to an [agent](https://docs.jinn.so/agents/add-an-agent.md). Every chat can use every skill,
including a chat with an agent in it. The two do different jobs: an agent's **Instructions**
say how it reads and thinks, and a skill holds how a job gets done and the material it needs.

## Where to go next

> [card] [Search your workspace](https://docs.jinn.so/find/search.md)
>
> Get a conversation back months later.

> [card] [Docs](https://docs.jinn.so/docs/write-a-doc.md)
>
> Create a doc, write in the editor, restore an earlier version.


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