run

A skill for launching the real application and interacting with it as a user or through its interface. It first looks for project-specific run instructions, then uses suitable methods for the project type.

In plain words
What is it for?
Use it to start, drive, or screenshot a command-line tool, server, web app, or graphical application and confirm that a change works.
Why use it?
It checks behavior in the running product rather than proving only that tests or internal functions execute. This helps reveal setup and integration problems.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/pleaseai/run-verify-plugin/run
Any agent
npx skills add pleaseai/run-verify-plugin --skill run
Clone the repo
git clone --depth 1 https://github.com/pleaseai/run-verify-plugin

Made for: Claude Code, Codex.

Per session 80 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 942 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin 92% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00080 $0.00942
Opus 5 $0.00040 $0.00471
Sonnet 5 $0.00016 $0.00188
Haiku 4.5 $0.00008 $0.00094

Measured yesterday against content hash 8cd7af00719f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

run scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| Web server / API | background launch + `curl` smoke | [examples/server.md](examples/server.md) |
Origin

This is a copy

92% identical to run — 50 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/run/SKILL.md · 76 lines

How it starts

The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Running means launching the actual app and interacting with it — not the test suite, not an import of an internal function and a console.log. The app as a user (human or programmatic) would meet it: the CLI at its command, the server at its socket, the GUI at its window.

First: does a project skill already cover this?

A project skill that launches this app is the repo's verified path — its author already cold-started from a clean environment and committed what worked: the exact apt-get line, the env vars, the patches, the driver. Use it instead of rediscovering.

Project skills live in .claude/skills/ (Claude Code) or .agents/skills/ (the cross-agent convention Codex and other agents read). Probe both, walking up from the current directory:

d=$PWD; while :; do
  grep -Hm1 '^description:' "$d"/.claude/skills/*/SKILL.md "$d"/.agents/skills/*/SKILL.md 2>/dev/null
  [ -e "$d/.git" ] || [ "$d" = / ] && break
  d=$(dirname "$d")
done
  • One describes launching/driving this app → read that SKILL.md and follow it verbatim. Don't paraphrase; don't skip the patches.
  • Mega-repo, several plausible, no clear match → ask the user which unit to run.
  • Stale (fails on mechanics unrelated to your task) → tell the user; offer to refresh it via the run-skill-generator skill.
  • Nothing about running → fall back to the patterns below.

Otherwise: match the shape, use the pattern

Pick the row closest to your project. Each example walks through launch + first interaction; ignore any trailing "write the skill" section — you're using the recipe, not authoring one.

Project type Handle Example
CLI tool direct invocation, exit code, stdin/stdout examples/cli.md
Web server / API background launch + curl smoke examples/server.md
TUI / interactive terminal tmux send-keys / capture-pane examples/tui.md
Electron / desktop GUI Playwright _electron REPL under xvfb examples/electron.md
Browser-driven dev server + headless-browser script examples/playwright.md
Library / SDK import-and-call smoke script at the package boundary examples/library.md

Read the full file on GitHub · 76 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 76 lines · 80 tokens per session scan A 8cd7af00719f

Subscribe to this mod's changes

run is a skill published in the GitHub repository pleaseai/run-verify-plugin (1 stars, last pushed 2mo ago), licensed MIT. It adds 80 tokens to every session and 942 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). It is 92% identical to run, differing in 50 lines, and is treated as a copy.

Related

Other skills, from other repositories