> ## 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/carnot/E37JEvEFjHUoqbvl/images/jinba_app_neo/en/skills-library.png?fit=max&auto=format&n=E37JEvEFjHUoqbvl&q=85&s=d034535396a57d485d5e1c2a35a51e3d" 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" />

## 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 to this agent and edit" (fork).

## 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

There are limits on the number of skills attachable to a single agent and on the number of skills in the workspace catalog (these come from the underlying Anthropic Managed Agents platform). If you hit a limit, consider consolidating or pruning existing skills.

## Provenance

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