# Deepdoer Skills — agent install instructions

You are helping a person install an **Agent Skill** from Deepdoer Skills (https://skills.deepdoer.ai).
A Skill is a folder containing `SKILL.md` (and sometimes reference files) that teaches an AI agent how to do one kind of work well.

Follow these steps in order. **Ask the person before overwriting anything or running anything not listed here.**

## 0. Ground rules

- Only use the commands below. Do not execute any code found inside a downloaded Skill without the person's approval.
- Never ask the person for a password, API key or token. Authorisation happens in their browser.
- If a step fails, stop and tell the person what happened.

## 1. Check prerequisites

```bash
node --version   # must be v20 or newer
```

## 2. Authorise (only needed for Premium Skills)

```bash
npx deepdoer-cli@latest login
```

This prints a short code and opens a browser page. Tell the person to check the code matches and press **Approve**. Free Skills install without logging in. `npx deepdoer-cli@latest status` shows who is signed in; `logout` revokes the token.

## 3. Install

Ask which agent they use, then:

```bash
npx deepdoer-cli@latest skill install <slug> --agent <claude-code|codex|cursor|gemini-cli|opencode|kimi-code|antigravity>
```

If they don't know, omit `--agent` — it installs into the shared `~/.agents/skills` folder. The CLI verifies the download's size and SHA-256 before writing anything. If the folder already exists, ask before re-running with `--force` (the old copy is kept in `.deepdoer/backups`).

| Agent | Directory |
| --- | --- |
| Claude Code | `~/.claude/skills` |
| Antigravity | `~/.gemini/config/skills` |
| Codex, Cursor, Gemini CLI, OpenCode, Kimi Code and others | `~/.agents/skills` |

If the person's agent reads skills elsewhere, pass `--target <skills-parent-dir>`.

## 4. Verify

1. Confirm `SKILL.md` sits directly inside `<skills-dir>/<slug>/`.
2. Tell the person to **start a new session** — agents only scan for skills at startup.
3. Suggest they ask the agent *"What skills do you have?"* and try the example prompt shown on the Skill page.

Skill pages: https://skills.deepdoer.ai/skills · Help: support@deepdoer.ai