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

# Skills Overview

> How skills — reusable playbooks and instructions for the AI — work

A **skill** is a reusable playbook or set of instructions the AI can draw on. Write routine know-how in Markdown — "How to create an invoice," "Report formatting," "Translation tone guide" — and the AI will reference it at the right moments.

Workspace-shared skills are managed on the "**Skills**" page in the "Configure" section of the sidebar.

<img src="https://mintcdn.com/jinba/B0KuFPdq9oF6s05P/images/jinba_app_neo/en/skills-library.png?fit=max&auto=format&n=B0KuFPdq9oF6s05P&q=85&s=ada87e7709fd7730580d46bd4400cf55" alt="Skills page" style={{ width: '100%', borderRadius: '8px', margin: '32px 0' }} width="1500" height="950" data-path="images/jinba_app_neo/en/skills-library.png" />

The page opens as a card grid — switch between "**Card view**" and "**List view**" with the toggle in the header. Click a card to open the skill's details.

## Anatomy of a skill

A skill follows the SKILL.md format: metadata (frontmatter) plus a body.

| Field                        | Description                                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------- |
| **Name**                     | The skill's name (e.g., PDF Extract)                                                   |
| **Description**              | What the skill does and when to use it. This is how the AI decides which skill to pick |
| **Allowed tools** (optional) | Restricts which tools this skill may use. Leave blank for no restriction               |
| **Body**                     | The procedures and instructions, written in Markdown                                   |

## Where skills are saved (scope)

| Location             | Description                                                                              |
| -------------------- | ---------------------------------------------------------------------------------------- |
| **Workspace shared** | Attachable by every agent. Shown on the Skills page                                      |
| **Agent-specific**   | Used by one agent only. Managed in the Skills section of the agent's configuration panel |

You can promote (agent-specific → shared) or demote (shared → agent-specific) a skill later. To tweak a shared skill for one agent, use "Copy and edit for this agent only" (fork).

Attaching a workspace-shared skill to an agent works from the Skills section of the agent's configuration panel — or straight from a chat with the agent ([Create Skills from Chat](/en/pages/jinba_app_neo/skills/from-chat)).

## Four ways to create a skill

<CardGroup cols={2}>
  <Card title="Write it in the editor" icon="pen" href="/en/pages/jinba_app_neo/skills/create">
    Write SKILL.md directly from "New skill" on the Skills page
  </Card>

  <Card title="Have the AI generate it" icon="wand-magic-sparkles" href="/en/pages/jinba_app_neo/skills/create">
    Enter a name and description, then "Auto-generate body"
  </Card>

  <Card title="Import a .md file" icon="file-import" href="/en/pages/jinba_app_neo/skills/create">
    Import an existing SKILL.md by drag & drop or paste
  </Card>

  <Card title="Accept a suggestion from chat" icon="comments" href="/en/pages/jinba_app_neo/skills/from-chat">
    The AI suggests turning procedures established in conversation into skills
  </Card>
</CardGroup>

## Limits

A single agent can have at most **20** skills attached, and the workspace catalog is capped at the same number. You do not have to count them yourself:

* The agent's "Add skills" picker shows the headroom as "**N / 20 left**"
* The Skills page adds an "**n / 20**" counter beside the page title once two or fewer slots are left
* An in-chat skill suggestion that would go over the limit says so and names the number

If you hit a limit, consider consolidating or pruning existing skills.

## Provenance

The skill list shows each skill's provenance (**Manual / AI generated / Imported**), and you can filter by it.