agrx — Run Skills Without Installing¶

agrx is an ephemeral skill runner. It downloads a skill from GitHub, runs it with your AI coding tool's CLI, and cleans up afterwards. Nothing is added to agr.toml.

Quick Start¶

agrx anthropics/skills/pdf                          # Run once, then clean up
agrx anthropics/skills/pdf -p "Extract tables"      # Pass a prompt
agrx kasperjunge/commit -i                          # Interactive: skill + chat

How It Works¶

Determine tool — Uses --tool flag, or default_tool from agr.toml, or the first tool in tools, or claude
Download skill — Clones the repo and extracts the skill (same as agr add)
Install temporarily — Places the skill in your tool's skills directory with a unique _agrx_ prefix so it doesn't conflict with permanent installs
Run the tool's CLI — Invokes the tool (e.g., claude -p "/skill-name") to execute the skill
Clean up — Removes the temporary skill directory, even on Ctrl+C

Options¶

Flag	Short	Description
`--tool`	`-t`	Tool CLI to use (claude, cursor, codex, opencode, copilot, antigravity)
`--interactive`	`-i`	Run skill, then continue in interactive mode
`--prompt`	`-p`	Prompt to pass to the skill
`--global`	`-g`	Install to global skills directory instead of project-local
`--source`	`-s`	Use a specific source from `agr.toml`

Examples¶

Run with a specific tool¶

agrx anthropics/skills/pdf --tool codex
agrx anthropics/skills/pdf --tool cursor
agrx anthropics/skills/pdf --tool opencode

Interactive mode¶

The -i flag runs the skill first, then starts an interactive session so you can continue the conversation:

agrx kasperjunge/commit -i

Pass a prompt¶

agrx anthropics/skills/pdf -p "Extract all tables from report.pdf as CSV"

Use a custom source¶

agrx team/internal-skill --source my-server

Run outside a git repo¶

agrx requires a git repository by default. Use --global to run anywhere:

agrx anthropics/skills/pdf --global

Differences from `agr add`¶

	`agr add`	`agrx`
Persists skill	Yes (permanent install)	No (cleaned up after run)
Updates `agr.toml`	Yes (adds dependency)	No
Runs the skill	No	Yes (invokes tool CLI)
Local paths	Supported	Not supported (remote only)
Multi-tool	Installs to all configured tools	Uses one tool

Tool CLI Requirements¶

agrx needs the tool's CLI to be installed. If it's missing, you'll see an error with installation instructions:

Tool	CLI	Install
Claude Code	`claude`	claude.ai/download
Cursor	`agent`	Install Cursor IDE
OpenAI Codex	`codex`	`npm i -g @openai/codex`
OpenCode	`opencode`	opencode.ai/docs/cli
GitHub Copilot	`copilot`	Install GitHub Copilot CLI
Antigravity	—	No CLI available; use `agr add` to install skills instead