# skill

> List and load Zeptap's skills (guides for apps and jobs), and install the skill that teaches agents the zeptap command.

Source: https://zeptap.com/docs/cli/commands/skill



## Usage [#usage]

```sh
zeptap skill list
zeptap skill get <name> [--file <path>]
zeptap skill install [--client claude|agents|cursor|all]
zeptap skill print
```

## Subcommands [#subcommands]

| Subcommand                 | What it does                                                                                       |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| `list`                     | The skills turned on in **Settings › Skills**, built in and your own, with a one-line summary each |
| `get <name>`               | Print a skill's guide, and list its extra files                                                    |
| `get <name> --file <path>` | Print one of the skill's files, such as `references/pickers.md`                                    |
| `install`                  | Write the `zeptap` SKILL.md where agents look for skills                                           |
| `print`                    | Print that SKILL.md                                                                                |

## Options [#options]

| Option            | Description                                                                      |
| ----------------- | -------------------------------------------------------------------------------- |
| `--file <path>`   | With `get`: one of the skill's files instead of its main guide                   |
| `--client <list>` | With `install`: `claude`, `agents`, `cursor` or `all` (default), comma-separated |

Also takes `--json`.

## Details [#details]

* Zeptap's [skills](https://zeptap.com/docs/agents/tools#skills) are guides for one app or one kind of job, such as `iphone-use` or `whatsapp-messages`. Before a job in an app, run `skill list` and, if one matches, `skill get` it and follow it.
* `skill list` also names the skills turned off in Zeptap. `skill get` refuses those.
* `install` writes `~/.claude/skills/zeptap/SKILL.md`, `~/.agents/skills/zeptap/SKILL.md` and `~/.cursor/skills/zeptap/SKILL.md`. With `all`, it skips Claude Code and Cursor when they aren't on this Mac.
* `install` doesn't add permission or sandbox rules. **Settings › Connectors › Command line** does. See [Teach your agents](https://zeptap.com/docs/cli/setup#teach-your-agents).

## Examples [#examples]

```sh
$ zeptap skill list
$ zeptap skill get iphone-use
$ zeptap skill get iphone-use --file references/pickers.md
$ zeptap skill install --client claude
```

## MCP tool [#mcp-tool]

[`load_skill`](https://zeptap.com/docs/agents/tools#load_skill) for `get`.
