# barndog skills (/docs/cli/skills)

All `skills` commands need a connected server. See [Authentication](/docs/cli/authentication).

## `barndog skills list` [#barndog-skills-list]

Browse accessible published Skills with their origin, current version, and description. Results are sorted and shown in pages of 20. Listing never installs anything.

```bash
barndog skills list
```

| Option                | Description                                                                             |
| --------------------- | --------------------------------------------------------------------------------------- |
| `--search <keywords>` | Match keywords in names, descriptions, and origins.                                     |
| `--origin <origin>`   | Filter by `org`, `team/name`, `repo/name`, or `dev/name`; a type alone lists that type. |
| `--page <number>`     | Page number, starting at 1.                                                             |
| `--limit <number>`    | Results per page, default 20, maximum 100.                                              |

Filtering and pagination apply locally to the complete visible catalog.

## `barndog skills install <name>` [#barndog-skills-install-name]

Selects a published Skill and delivers it to your selected harnesses straight away.

```bash
barndog skills install code-review --origin team/platform
```

| Option              | Description                              |
| ------------------- | ---------------------------------------- |
| `--origin <origin>` | Required. The scope that owns the Skill. |

The Skill's permanent ID is saved in `~/.barndog/config.yaml`, and later syncs follow its new published versions. See [Install and manage Skills](/docs/guides/install-skills).

## `barndog skills pull <name>` [#barndog-skills-pull-name]

Pulls a published Skill into a new folder that you can edit.

```bash
barndog skills pull code-review --origin team/engineering
```

| Option               | Description                                                         |
| -------------------- | ------------------------------------------------------------------- |
| `--origin <origin>`  | Required. The scope that owns the Skill.                            |
| `--directory <path>` | Where to create the folder. Defaults to `./<name>`. Must not exist. |

Working copies are separate from installed Skills. See [Working copies](/docs/cli/working-copies).

## `barndog skills versions <name>` [#barndog-skills-versions-name]

Lists a Skill's published versions.

```bash
barndog skills versions code-review --origin team/engineering
```

| Option              | Description                              |
| ------------------- | ---------------------------------------- |
| `--origin <origin>` | Required. The scope that owns the Skill. |

## `barndog skills show <name>` [#barndog-skills-show-name]

Shows the files in a published version.

```bash
barndog skills show code-review --origin team/engineering --version 3
```

| Option               | Description                                           |
| -------------------- | ----------------------------------------------------- |
| `--origin <origin>`  | Required. The scope that owns the Skill.              |
| `--version <number>` | The version to show. Defaults to the current version. |

## `barndog skills diff <name>` [#barndog-skills-diff-name]

Compares two published versions.

```bash
barndog skills diff code-review --origin team/engineering --from 2 --to 3
```

| Option              | Description                              |
| ------------------- | ---------------------------------------- |
| `--origin <origin>` | Required. The scope that owns the Skill. |
| `--from <number>`   | Required. The older version.             |
| `--to <number>`     | Required. The newer version.             |