# RivalCheck: install guide

RivalCheck is a free, open-source skill that turns your agent into a careful competitor analyst. Name a rival, and it writes a dossier of their plans, prices, limits and positioning. Every value is quoted word for word from a page it captured and checked by a small script. It runs on your own model, with no account and no API key.

## If you are an AI agent installing RivalCheck

The user asked you to install it. There are two files, and no package manager is needed:

- `SKILL.md`: https://rivalcheck.com/skill/SKILL.md
- `rivalcheck.py`: https://rivalcheck.com/skill/rivalcheck.py (Python 3.8+, standard library only)

1. **Pick the folder.**
   - **Claude Code:** `~/.claude/skills/rivalcheck/` for every project, or `.claude/skills/rivalcheck/` for this project only. Ask the user if you're not sure which they want.
   - **Another agent with a skills folder:** `<that folder>/rivalcheck/`.
   - **Otherwise:** `.agents/skills/rivalcheck/` in the current project. Then add this line to `AGENTS.md`, creating the file if needed: `For competitor or pricing research, follow .agents/skills/rivalcheck/SKILL.md.`
2. **Download both files into that folder:**
   ```
   mkdir -p <folder> && cd <folder>
   curl -fsSLO https://rivalcheck.com/skill/SKILL.md
   curl -fsSLO https://rivalcheck.com/skill/rivalcheck.py
   ```
3. **Check it runs:** `python3 <folder>/rivalcheck.py --version` should print a version number.
4. **Read `SKILL.md` before first use.** Tell the user it's installed, and that they can say "rivalcheck linear.app" (or any rival) to start. Dossiers are saved under `rivals/` in their project.

## If you are a person

Paste this into your agent: `Install the RivalCheck skill from https://rivalcheck.com/skill.md`

Or run the two `curl` lines above yourself. Read the files first: https://rivalcheck.com/skill/SKILL.md and https://rivalcheck.com/skill/rivalcheck.py.

- Example output: https://rivalcheck.com/skill/example
- Want it done for you, with every line checked by hand? https://rivalcheck.com/service
