# Install Skill

> Install a Claude Code skill from a GitHub skills repository URL.

- Skill: `atman-33/install-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add atman-33/install-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/atman-33/install-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: atman-33 (https://skillmd.com/u/atman-33)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/atman-33/install-skill

---

Install a Claude Code skill from a GitHub skills repository URL.

## Steps

1. **Route the input.** Decide whether the user gave a GitHub tree URL or a repo/skill reference.
   - Completion criterion: the input is classified as exactly one of URL or reference.

2. **Extract repo and skill path.** For a tree URL of the form `https://github.com/OWNER/REPO/tree/<ref>/skills/<category>/<skill>`, extract `OWNER/REPO` and the path under `skills/` — for example, `productivity/writing-great-skills`. If the user gave `OWNER/REPO <path>` directly, use it as-is.
   - Completion criterion: both the repository and the skill path are identified.

3. **Install for Claude Code.** Run:
   ```bash
   gh skill install <repo> <skill-path> --agent claude-code
   ```
   - Completion criterion: the command exits successfully.

4. **Report result.** Show the installed skill path and any warnings.
   - Completion criterion: the user can see whether the install succeeded.

## Failure modes

- `gh` missing or unauthenticated: stop and ask the user to run `gh auth login`.
- URL with no `skills/` segment: stop and ask for a repo/skill reference.
- `gh skill install` fails: print the full error and do not retry.