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

# Create and Edit Skills

> Using the skill editor — writing by hand, auto-generating, and importing

## Opening the skill editor

* **Workspace-shared skills**: Sidebar > Configure > **Skills** > "New skill"
* **Agent-specific skills**: Agent's configuration panel > **Skills** section > "Create new"

Open an existing skill with "Edit" from the list. On the Skills page, creating and editing happen in a pane to the right of the list (on narrow screens it opens as a drawer).

## The editor

<Steps>
  <Step title="Fill in the frontmatter (metadata)">
    * **Name** (required) — e.g., PDF Extract
    * **Description** — what this Skill does and when it should be invoked. Be specific: the AI uses this to decide whether to use the skill
    * **Allowed tools** (optional) — comma-separated tool names. Leave blank for no restriction
  </Step>

  <Step title="Write the body">
    Write the Markdown body on the "Edit" tab. Check how it looks on the "Preview" tab.

    <Tip>
      Enter the name and description, then press "**Auto-generate body**" to have the AI draft a body from what you have entered.
    </Tip>
  </Step>

  <Step title="Choose where to save it">
    * **Workspace shared** — attachable by every agent
    * **This agent only** — agent-specific (when created from the agent detail page)

    You can change the location later (promote / demote). Creating a **workspace-shared** skill asks for a final confirmation ("**Create new workspace skill?**") — other members will be able to see and use it, so make sure it contains nothing personal or private.
  </Step>
</Steps>

## Importing an existing SKILL.md

When creating a skill, an import dropzone sits at the top of the form — "**Drag a SKILL.md here**," or click it to browse. Pasting SKILL.md text into the editor works too.

* The frontmatter (name, description, tools) and body are filled into the form automatically
* Markdown files (`.md`) only, up to 1 MB each

<Warning>
  On the workspace Skills page, dropping **several** files at once skips the form and immediately creates one **workspace-shared** skill per file — no per-skill confirmation. Make sure the files contain nothing personal or private before dropping them.
</Warning>

## Editing shared skills, and forking

<Warning>
  Editing a workspace-shared skill **affects every agent** it is attached to.
</Warning>

To adapt a shared skill for a specific agent, fork it first with "**Copy to this agent and edit**" in the editor, then make your changes. The original skill is unaffected.

## Deleting

Delete from the editor or from the list. Deleting an agent-specific skill cannot be undone.

## Writing tips

* **One skill, one purpose** — split multiple procedures into separate skills instead of cramming them into one
* **The description is everything** — the AI reads the description to decide "should I use this skill now?" Spell out "use this when …"
* **Number your steps** — explicit ordering and conditions are more reliable than vague phrasing