One-shot lifecycle command that chains init → baseline → spawn → eval → merge in a single invocation.

MITAuto-check passed

Install Run

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill run -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills run --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/agenthub/skills/run .claude/skills/run && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
run
GitHub stars
28k
Token cost
~944 tokens
SKILL.md length
374 words
Files
1
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

One-shot lifecycle command that chains init → baseline → spawn → eval → merge in a single invocation.

  • Works in 6 steps: Initialize → Capture Baseline → Spawn Agents → …
  • The user runs /hub:run
  • SKILL.md covers Usage, Parameters, What It Does and Critical Rules
  • Calls python

What it does

Run is an agent skill from alirezarezvani/claude-skills. One-shot lifecycle command that chains init → baseline → spawn → eval → merge in a single invocation. Use when the user runs /hub:run or asks to execute a full AgentHub competition end-to-end.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • The user runs /hub:run
  • Asks to execute a full AgentHub competition end-to-end

Example prompts

  • “/run”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Initialize
  2. Capture Baseline
  3. Spawn Agents
  4. Wait and Monitor
  5. Evaluate
  6. Confirm and Merge

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Run loads about 944 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 374 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~944

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 374 words, ~944 tokens.

Download SKILL.mdSave it as .claude/skills/run/SKILL.md (or your agent's skills folder).
name
run
description
One-shot lifecycle command that chains init → baseline → spawn → eval → merge in a single invocation. Use when the user runs /hub:run or asks to execute a full AgentHub competition end-to-end.
command
/hub:run

/hub:run — One-Shot Lifecycle

Run the full AgentHub lifecycle in one command: initialize, capture baseline, spawn agents, evaluate results, and merge the winner.

Usage

/hub:run --task "Reduce p50 latency" --agents 3 \
  --eval "pytest bench.py --json" --metric p50_ms --direction lower \
  --template optimizer

/hub:run --task "Refactor auth module" --agents 2 --template refactorer

/hub:run --task "Cover untested utils" --agents 3 \
  --eval "pytest --cov=utils --cov-report=json" --metric coverage_pct --direction higher \
  --template test-writer

/hub:run --task "Write 3 email subject lines for spring sale campaign" --agents 3 --judge

Parameters

ParameterRequiredDescription
--taskYesTask description for agents
--agentsNoNumber of parallel agents (default: 3)
--evalNoEval command to measure results (skip for LLM judge mode)
--metricNoMetric name to extract from eval output (required if --eval given)
--directionNolower or higher — which direction is better (required if --metric given)
--templateNoAgent template: optimizer, refactorer, test-writer, bug-fixer

What It Does

Execute these steps sequentially:

Step 1: Initialize

Run /hub:hub-init with the provided arguments:

bash
python {skill_path}/scripts/hub_init.py \
  --task "{task}" --agents {N} \
  [--eval "{eval_cmd}"] [--metric {metric}] [--direction {direction}]

Display the session ID to the user.

Step 2: Capture Baseline

If --eval was provided:

  1. Run the eval command in the current working directory
  2. Extract the metric value from stdout
  3. Display: Baseline captured: {metric} = {value}
  4. Append baseline: {value} to .agenthub/sessions/{session-id}/config.yaml

If no --eval was provided, skip this step.

Step 3: Spawn Agents

Run /hub:spawn with the session ID.

If --template was provided, use the template dispatch prompt from ../agenthub/references/agent-templates.md instead of the default dispatch prompt. Pass the eval command, metric, and baseline to the template variables.

Launch all agents in a single message with multiple Agent tool calls (true parallelism).

Show full SKILL.md (167 more words)Show less
Step 4: Wait and Monitor

After spawning, inform the user that agents are running. When all agents complete (Agent tool returns results):

  1. Display a brief summary of each agent's work
  2. Proceed to evaluation
Step 5: Evaluate

Run /hub:eval with the session ID:

  • If --eval was provided: metric-based ranking with result_ranker.py
  • If no --eval: LLM judge mode (coordinator reads diffs and ranks)

If baseline was captured, pass --baseline {value} to result_ranker.py so deltas are shown.

Display the ranked results table.

Step 6: Confirm and Merge

Present the results to the user and ask for confirmation:

Agent-2 is the winner (128ms, -52ms from baseline).
Merge agent-2's branch? [Y/n]

If confirmed, run /hub:merge. If declined, inform the user they can:

  • /hub:merge --agent agent-{N} to pick a different winner
  • /hub:eval --judge to re-evaluate with LLM judge
  • Inspect branches manually

Critical Rules

  • Sequential execution — each step depends on the previous
  • Stop on failure — if any step fails, report the error and stop
  • User confirms merge — never auto-merge without asking
  • Template is optional — without --template, agents use the default dispatch prompt from /hub:spawn

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in engineering/agenthub/skills/run of alirezarezvani/claude-skills.

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Run next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Run compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run this skillalirezarezvani/claude-skills28k—~944Automated safety check: PassMIT
Initasgeirtj/system_prompts_leaks69k—~5.5kAutomated safety check: PassCC0-1.0
Initasgeirtj/system_prompts_leaks69k—~602Automated safety check: PassCC0-1.0
Sbom Supply Chainsickn33/agentic-awesome-skills47k2 repos~3.4kAutomated safety check: PassMIT
Agent Supply Chaingithub/awesome-copilot40k1 repos~2.7kAutomated safety check: PassMIT
Supply Chain Securityzhaoxuya520/reverse-skill40k4 repos~953Automated safety check: WarnMIT

Similar skills

  • Init

    asgeirtj/system_prompts_leaks

    Initialize new CLAUDE.md file(s) and optional skills/hooks with codebase documentation

    69k GitHub stars~5.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Init

    asgeirtj/system_prompts_leaks

    Initialize a new CLAUDE.md file with codebase documentation. An agent skill from asgeirtj/system_prompts_leaks.

    69k GitHub stars~602 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Sbom Supply Chain

    sickn33/agentic-awesome-skills

    Generate, sign, and verify SBOMs and provenance attestations to secure the software supply chain.

    47k GitHub starsUsed in 2 repos~3.4k tokens
    SecurityAuto-check passed
  • Agent Supply Chain

    github/awesome-copilot

    Official

    Verify supply chain integrity for AI agent plugins, tools, and dependencies.

    40k GitHub starsUsed in 1 repo~2.7k tokens
    SecurityAuto-check passed
  • Supply Chain Security

    zhaoxuya520/reverse-skill

    A skill your agent uses for software supply-chain security assessment covering SBOM, SCA, CI/CD pipelines, container images, build integrity, dependency provenance, and vulnerability reachability.

    40k GitHub starsUsed in 4 repos~953 tokens
    SecurityAuto-check: warnings
  • Canonical Chain

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Avoid redirect chains on canonical URLs.

    74k GitHub stars~417 tokensUpdated yesterday
    Marketing & SEOAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Run

What does Run do?

One-shot lifecycle command that chains init → baseline → spawn → eval → merge in a single invocation. Run is an agent skill from alirezarezvani/claude-skills. One-shot lifecycle command that chains init → baseline → spawn → eval → merge in a single invocation.

When should I use Run?

Run fits situations like: the user runs /hub:run; asks to execute a full AgentHub competition end-to-end.

How do I install Run in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill run -a claude-code`. Or copy the skill folder (engineering/agenthub/skills/run in alirezarezvani/claude-skills) into .claude/skills/run in your project. Claude Code loads it when a task matches its description.

How do I install Run in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill run -a codex`. Or copy the skill folder (engineering/agenthub/skills/run in alirezarezvani/claude-skills) into .agents/skills/run in your project. Codex loads it when a task matches its description.

Can I use Run in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill run -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run, .gemini/skills/run, .github/skills/run and .opencode/skills/run in your project.

What does Run need to run?

Going by SKILL.md and its folder, Run needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Run access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Run safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Run use?

Run is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run use?

About 944 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Run?

Skills that share tags, products or a category with Run: Init (asgeirtj/system_prompts_leaks, 69k stars), Init (asgeirtj/system_prompts_leaks, 69k stars), Sbom Supply Chain (sickn33/agentic-awesome-skills, 47k stars) and Agent Supply Chain (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,829 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.