---
title: "Skills"
description: "Package reusable workflows and expertise for agents to load when the task calls for them."
canonical_url: "https://hoplite.sh/docs/agent/skills"
markdown_url: "https://hoplite.sh/docs/agent/skills.md"
---

# Skills
URL: /docs/agent/skills
LLM index: /llms.txt
Description: Package reusable workflows and expertise for agents to load when the task calls for them.
Related: /docs/agent/instructions, /docs/cli, /docs/automations

# Skills

Turn repeatable workflows and team expertise into versioned instruction bundles. Hoplite agents load skills when they apply, by reading repository files or using `load_skill` for hosted skills. Use [instructions](/docs/agent/instructions) for guidance that belongs in every run.

Skills come in three flavors:

- **Project skills** live in the repository and apply to everyone working in it.
- **Organization skills** live in a shared Hoplite library and apply across the organization's projects.
- **Personal skills** live in your personal Hoplite library and apply to runs you initiate.

## Organization skills

Organization owners and admins manage shared skills under **Settings → Workspace → Agents**, in **Workspace skills**, and can also create, update, and delete them through the API. All organization members can read the library. The same page shows how the instruction and skill layers stack. Use it for reusable team workflows that should be available across repositories without copying files into each project.

Organization skills are available to every run in the organization, including [automations](/docs/automations) and Linear-delegated runs. Each run keeps a snapshot of the organization skills it started with, so later library edits apply to subsequent runs rather than changing an active run.

## Name precedence

When skills share a name, Hoplite selects one in this order: **project (repository) → organization → personal → built-in**. A project can specialize a shared organization workflow, while organization skills take precedence over a member's personal version.

Within the repository, the directory precedence is `.agents/skills` → `.claude/skills` → `.cursor/skills` → `.codex/skills`. Agents read repository skills from the checkout; organization, personal, and built-in skills are loaded through `load_skill`.

## Create a project skill

Use the [CLI](/docs/cli) to scaffold one in the current repository, with a concise description of when it applies:

```bash title="terminal"
hoplite skills add release-check --description "Prepare and verify a production release"
```

The command creates `.agents/skills/release-check/SKILL.md`, the standard project skill location. Add the project-specific workflow to that file and commit it; agents see it when they work from the repository.

Use `hoplite skills list` to inspect the skills available from `.agents/skills` and the compatible `.claude/skills` location.

## Import personal skills

To copy selected skills you installed locally with `npx skills add ... --global` into your personal Hoplite library, run:

```bash title="terminal"
hoplite skills import-global --name <skill-name>
```

Initial `hoplite onboard` presents these global skills as a default-selected personal-skills step before the final confirmation. You can still run the command later to add selected skills, use `--all --yes` for an explicit bulk import, or use `--replace` to overwrite a same-named personal skill. Every import reads only the root `SKILL.md` instructions.

<Callout type="info" title="Scope of personal skills">
Personal skills are available to human-initiated runs, never to [automations](/docs/automations) or Linear-delegated runs. Use organization skills for workflows those runs need. Personal skills are snapshotted when a run starts; repository and organization skills take precedence on name collisions.
</Callout>

## Commands

| Command | What it does |
| --- | --- |
| `hoplite skills add <name>` | Create a versioned project skill in `.agents/skills` |
| `hoplite skills list` | List project skills available to Hoplite agents |
| `hoplite skills import-global` | Add selected local global skills to your personal library |
