> ## 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. Skills page The page opens as a card grid — switch between "**Card view**" and "**List view**" with the toggle in the header; the view you pick is remembered on that device. Click a card to open the skill's details. Each card also shows how many times the skill has been invoked (for example "**12 invocations**"). The "…" menu offers **Edit**, **Download**, "**Use in chat**" — which opens a new chat with the skill already picked in the composer — "**Share with organization**," and **Delete**, and carries the same items wherever you open it — on a card in the grid, or on the detail header in list view. ## The detail drawer In card view — and in list view on a narrow window — a skill's details open in a drawer from the right. * "**Expand**" in the drawer header widens it to nearly the full window, and "**Collapse**" brings it back. The choice is remembered on that device, carries over to the next skill you open, and the editor inherits it too * Drag the handle on the drawer's left edge to set the width yourself, between 420 px and 92% of the window. The arrow keys move it 16 px at a time (four times that with Shift), Home and End go to either end, and a double-click restores the default width * A width you drag lasts only while that drawer is open — it is not saved. The mobile bottom sheet has no handle ## 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 Write SKILL.md directly from "New skill" on the Skills page Enter a name and description, then "Auto-generate body" Import an existing SKILL.md by drag & drop or paste The AI suggests turning procedures established in conversation into skills ## 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. ## Version history A workspace skill's detail view has two tabs: "**Details**" — description, source, how many agents use it, an "**Invocations**" count, and the body — and "**History**." The Invocations figure counts how many AI turns have loaded this skill since counting began (several reads within one turn count once). The body preview keeps the line breaks you wrote — a lone newline renders as a line break rather than collapsing into a space (the same in the editor's Preview tab and an agent's Instructions preview). * The history lists past versions with what produced each one: **Created**, **Edited**, **Updated from chat**, **Updated by AI**, **Restored**, or **Initial version**. "**Load earlier versions**" pulls in more * Open a version to read its frontmatter (name, description, allowed tools) and body exactly as they were then * "**Restore this version**" brings those contents back **as a new latest version** — your current content is not discarded, it stays in the history. Agents in the workspace that have the skill attached move to the new latest version automatically ## Provenance The skill list shows each skill's provenance (**Manual / AI generated / Imported**), and you can filter by it.