Skip to content

drafael/coding-harness / skills/skill-hunter

skill-hunter

Verified

Use when the user wants to find NEW external skills for a project, build a skill stack from external registries, or compare external options against project needs. Do not use for questions about how to use already-installed/local skills.

FileKindSize
LICENSEother1.0 KB
README.mdmarkdown843 B
SKILL.mdskill md14.1 KB
references/agent-skills.mdmarkdown10.8 KB
references/installation.mdmarkdown5.7 KB

references/installation.md

View on GitHub
# Installation Guide (Agent-Agnostic)

Use this reference only **after** the user confirms the stack.

## Preferred (source-aware, multi-agent)
Use the Skills CLI only when the skill is known to be supported by it (e.g., discovered via `npx skills find` or listed on skills.sh). Do **not** default to Skills CLI for arbitrary repos.

```bash
npx skills add owner/repo --skill skill-name -a <current-agent> -y
```

Notes:
- `-a` targets agents; use `--all` to install to all detected agents.
- If a user wants project-level only, use the agent’s project skills path instead.
- If the skill did **not** come from Skills CLI discovery, use a source-verified install method instead (see below).
- Do **not** rely on auto‑detect when installing. Always pass `-a <current-agent>` unless the user explicitly asks for multi‑agent installs.
- If a skill was not found via `npx skills find`, verify availability with `npx skills add <repo> --list` before installing via Skills CLI.

## Skills CLI essentials (skills.sh)
Use these only for skills discoverable via Skills CLI (skills.sh).

Source formats:
```bash
# GitHub shorthand (owner/repo)
npx skills add vercel-labs/agent-skills

# Full GitHub URL
npx skills add https://github.com/vercel-labs/agent-skills

# Direct path to a skill in a repo
npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# GitLab URL (including subgroups)
npx skills add https://gitlab.com/org/repo
npx skills add https://gitlab.com/org/subgroup/repo

# Any git URL (including custom Git hosts)
npx skills add git@github.com:vercel-labs/agent-skills.git

# Local path
npx skills add ./my-local-skills
```

Key options (verify in `npx skills --help` if unsure):
- `-g, --global` install to user directory instead of project
- `-a, --agent <agents...>` target specific agents (supports fuzzy matching)
- `-s, --skill <skills...>` install specific skills (use `'*'` for all skills)
- `-l, --list` list available skills without installing
- `-y, --yes` skip confirmation prompts
- `--all` install all skills to all agents without prompts
- `--full-depth` deep directory scanning for repos with nested skills

> **Note:** `npx add-skill` is deprecated. Use `npx skills` for all operations.

```bash
# Search
npx skills find typescript

# List skills in a repo
npx skills add owner/repo --list

# Install specific skills
npx skills add owner/repo --skill skill-a --skill skill-b -a <current-agent> -y

# Install to global scope
npx skills add owner/repo --skill skill-a -g -a <current-agent> -y

# Check for updates / update
npx skills check
npx skills update

# Initialize a new skill
npx skills init my-skill

# Remove skills
npx skills remove web-design-guidelines
```

Installation methods (interactive):
- **Symlink** (recommended): single source of truth, easier updates
- **Copy**: use when symlinks are not supported

## Context7-sourced skills
If a skill came from Context7, follow Context7’s install guidance or CLI output. Do not use `npx skills add` unless the skill is also listed by Skills CLI.

Context7 CLI basics (from official docs):
```bash
# Install the CLI (optional) or run via npx
npm install -g ctx7
npx ctx7 skills search pdf

# Suggest skills based on project dependencies (scans package.json, requirements.txt, pyproject.toml)
ctx7 skills suggest
ctx7 skills suggest --claude

# Install skills from a project
ctx7 skills install /anthropics/skills
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf commit

# Target a specific client (--claude, --cursor, --codex, --opencode, --amp, --antigravity)
ctx7 skills install /anthropics/skills pdf --cursor
ctx7 skills install /anthropics/skills pdf --claude

# Install globally (home directory)
ctx7 skills install /anthropics/skills pdf --global

# List installed skills
ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
ctx7 skills list --global

# Show info / remove
ctx7 skills info /anthropics/skills
ctx7 skills remove pdf
ctx7 skills remove pdf --claude
ctx7 skills remove pdf --global
```

Context7 scope note:
- Context7 CLI auto‑detects supported clients and installs to those it recognizes.
- If the current agent is not supported by Context7, do **not** use ctx7 install; fall back to source‑verified manual install or the agent’s documented path.

## Codex CLI
Project-level path:
```
<repo>/.codex/skills/<skill-name>/
```

Install via Codex’s built-in skill installer (preferred for repo-based skills):
```
$skill-installer install https://github.com/owner/repo/tree/main/path/to/skill
```

Or describe it:
```
$skill-installer install the <skill-name> skill from owner/repo
```

Manual install:
```
mkdir -p .codex/skills
cp -R skill-name .codex/skills/
```

**Note:** Restart Codex after installing new skills.

## Claude Code (CLI)
Project-level (recommended):
```
<repo>/.claude/skills/<skill-name>/
```

Global:
```
~/.claude/skills/<skill-name>/
```

GitHub install:
```bash
# Project-level
mkdir -p .claude/skills && git clone https://github.com/owner/repo-name.git .claude/skills/skill-name

# Global
mkdir -p ~/.claude/skills && git clone https://github.com/owner/repo-name.git ~/.claude/skills/skill-name
```

## Claude (Web/Desktop)
Package the skill folder as a ZIP and upload via **Settings > Capabilities**.

## Other Clients
Ask for the official project-level skills path or CLI. If no official guidance exists, present a best-effort option and mark it unverified.

## Fallback (only if verified)
If install methods are unclear, **do not** hand-write or reconstruct a skill. Ask for an authoritative source (official repo, ZIP, or Skills CLI listing) and only install from that source.

If you must manually copy a verified skill, consult `references/agent-skills.md` for agent-specific paths, skill format, and discovery locations.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall