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

# Skills

> Turn a recurring workflow into a personal or project skill the agent loads automatically.

Skills are how you teach Fleet Prime Agent your workflows. Two flavors: markdown skills that describe what to do, and Python skills that run real code.

## When to reach for a skill

* You've explained the same procedure to the agent three times this week.
* Your team has a shared runbook (deploy, release, incident) you want the agent to follow.
* You want the agent to load a private CLI's schema or a project-specific convention every time.

## Anatomy

* **`MarkdownSkill`** — a `SKILL.md` file with front matter and a body. The front matter names the skill and describes when it should apply; the body is instructions the model reads on load.
* **`PythonSkill`** — an importable Python module. Add real functions, decorators, or IPython magics that the model can invoke during a session.

Skills register through the extension runtime (`ExtensionRuntime`, `ExtensionAPI`). Registering a skill adds its tools, slash commands, and keyboard shortcuts to the session automatically.

## Load skills

Point Fleet Prime Agent at a directory of skills:

```bash theme={null}
prime-agent --skill ./skills
```

Or wire it into your config so skills load every session. Under the hood the runtime calls `loadSkills` and `loadSkillsFromDir`.

## Personal vs project

Personal skills live under your home directory and load in every session. Project skills live in the repo (usually under `./skills/`) and only load when you launch Fleet Prime Agent from that repo.

## The built-in skill creator

When Fleet Prime Agent notices a recurring pattern in a session, the built-in skill creator can propose a skill from that trajectory. Accept it and the workflow becomes a first-class capability.

## Related

* [Tools, skills, and extensions](/fleet-prime-agent/concepts/tools-and-extensions) — how the three layers fit together.
* [Extensions](/fleet-prime-agent/guides/extensions) — the underlying mechanism.
* [Refinement](/fleet-prime-agent/guides/refinement) — the other way to teach the agent, without adding new capabilities.