# Create a skill

> Teach Geni a repeatable procedure it can load whenever the task calls for it.

A skill is a reusable set of instructions an agent can load on demand: your reporting format, your QA checklist, the exact steps for a monthly close. Write it once and every agent in the workspace can use it.

## Create the skill

<Steps>
  <Step>Open **Skills** in the sidebar and click **New**.</Step>
  <Step>
    Describe what the skill should teach an agent to do: the task, any
    conventions to follow, and the steps or resources an agent should use. The
    more detail, the better.
  </Step>
  <Step>
    Confirm, pick a model, and the author agent drafts the skill for you.
  </Step>
</Steps>

<Callout type="tip">
  Skills work best for procedures you repeat: "how we write release notes," "how
  to triage a support ticket," "our brand voice." One skill per procedure beats
  one giant skill for everything.
</Callout>

## Refine it

<Steps>
  <Step>
    Review the draft on the skill page and ask the author agent in chat to
    tighten or extend it.
  </Step>
  <Step>
    Skills are versioned. Open **Version history** from the skill menu to
    compare drafts or roll back.
  </Step>
</Steps>

## Use it

<Steps>
  <Step>
    In any chat, type **@** and mention the skill to have Geni use it right
    away. The skill page also has a **Use this skill in a chat** shortcut.
  </Step>
  <Step>
    Leave the skill **Enabled** and agents discover it on their own: whenever a
    task matches the skill's description, they load it automatically. Disable it
    to take it out of circulation without deleting it.
  </Step>
</Steps>

<Callout type="note">
  Check the **Platform Skills** tab for ready-made skills we maintain, and share
  your own skills with teammates from the skill page.
</Callout>

## Import an existing skill

Already have skills written elsewhere? Click **Upload** on the Skills page and drop in a `.zip` of a folder containing a `SKILL.md` file. The standard agent-skill format works as-is.