Agent skill

Runner

by agentuse in agentuse/agentuse

Run and manage AgentUse agents from the CLI. An agent skill from agentuse/agentuse.

Custom licenceAuto-check passed

Install Runner

skills CLI
$ npx skills add agentuse/agentuse --skill runner -a claude-code

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

GitHub CLI
$ gh skill install agentuse/agentuse runner --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/agentuse/agentuse.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill-data/runner .claude/skills/runner && 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
runner
GitHub stars
205
Token cost
~1k tokens
SKILL.md length
289 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

Run and manage AgentUse agents from the CLI. An agent skill from agentuse/agentuse.

  • Works in 3 steps: Confirm the project is in… → Confirm the daemon is up (agentuse serve… → Use a process manager for long-running…
  • You need to list agents
  • SKILL.md covers Commands, Serve Web UI, Scheduled Agents and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Runner is an agent skill from agentuse/agentuse. Run and manage AgentUse agents from the CLI. Use when you need to list agents, run an agent, inspect sessions, start or inspect the AgentUse server, work with schedules, or understand runtime command behavior.

Its SKILL.md is about 1k 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: 🤖 AI agents on autopilot. Any model. Runs local, cron, CI/CD, or Docker.

When your agent uses it

  • You need to list agents
  • Inspect sessions
  • Inspect the AgentUse server
  • Work with schedules

Example prompts

  • “/runner”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the project is in ~/.agentuse/config.json under serve.projects.
  2. Confirm the daemon is up (agentuse serve ps).
  3. Use a process manager for long-running schedules.

What it can do on your machine

Read from SKILL.md and the folder at commit 8e524de. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.agentuse.io

    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

Runner loads about 1k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 289 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 289 words (~1,028 tokens).

“Run .agentuse files, inspect their execution state, and operate the HTTP server used for webhooks, approvals, channels, and schedules.”

— opening of SKILL.md by agentuse, Custom licence
name
runner

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skill-data/runner of agentuse/agentuse.

Open the folder on GitHubat commit 8e524de

Compare with similar skills

Runner 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.

Runner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Runner this skillagentuse/agentuse205—~1kAutomated safety check: PassCustom licence
Agent Test Long Runnerruvnet/ruflo74k2 repos~426Automated safety check: PassMIT
Add Runner Evalpaperclipai/paperclip98k—~1kAutomated safety check: PassMIT
Pytest Runnersaleor/saleor23k—~251Automated safety check: PassBSD-3-Clause
Twenty Entity Runner Actionstwentyhq/twenty58k—~3.1kAutomated safety check: PassCustom licence
TiDB RealTiKV Test Runnerpingcap/tidb41k—~250Automated safety check: PassApache-2.0

Similar skills

  • Agent skill for test-long-runner - invoke with $agent-test-long-runner

    74k GitHub starsUsed in 2 repos~426 tokens
    Agent WorkflowsAuto-check passed
  • Add Runner Eval

    paperclipai/paperclip

    Add or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.

    98k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Pytest Runner

    saleor/saleor

    Run pytest tests with automatic virtual environment activation. Use this skill whenever running tests, executing pytest, or when asked to "run tests", "test…

    23k GitHub stars~251 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Step four of adding a syncable entity in the Twenty server: write create, update and delete action handlers that run workspace migrations against the database.

    58k GitHub stars~3.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Use when running tests under tests/realtikvtest that require a local TiUP playground lifecycle with strict startup, readiness checks, and cleanup.

    41k GitHub stars~250 tokensUpdated today
    Testing & QAAuto-check passed
  • Use when running TiDB package tests and deciding whether failpoint enable/disable is required before and after the test command.

    41k GitHub stars~256 tokensUpdated today
    Testing & QAAuto-check passed

More from agentuse/agentuse

  • Automate

    agentuse/agentuse

    Turn a workflow described or just completed in a coding agent into one focused, validated AgentUse agent.

    205 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Onboarding

    agentuse/agentuse

    Guide a new AgentUse user from a confirmed project to one validated first agent and its first CLI or Web UI run.

    205 GitHub stars~928 tokensUpdated yesterday
    Auto-check passed
  • Tester

    agentuse/agentuse

    Test and validate AgentUse agents without real side effects.

    205 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check: notes
  • Agentuse

    agentuse/agentuse

    AgentUse CLI and agent workflow guide. An agent skill from agentuse/agentuse.

    205 GitHub stars~490 tokensUpdated yesterday
    Auto-check passed
  • Creator

    agentuse/agentuse

    Create, improve, and review AgentUse agent files. An agent skill from agentuse/agentuse.

    205 GitHub stars~9.8k tokensUpdated yesterday
    Auto-check passed
  • Core

    agentuse/agentuse

    Core AgentUse usage guide. An agent skill from agentuse/agentuse.

    205 GitHub stars~700 tokensUpdated yesterday
    Auto-check passed

Questions about Runner

What does Runner do?

Run and manage AgentUse agents from the CLI. An agent skill from agentuse/agentuse. Runner is an agent skill from agentuse/agentuse. Run and manage AgentUse agents from the CLI.

When should I use Runner?

Runner fits situations like: you need to list agents; inspect sessions; inspect the AgentUse server; work with schedules.

How do I install Runner in Claude Code?

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

How do I install Runner in Codex?

Run `npx skills add agentuse/agentuse --skill runner -a codex`. Or copy the skill folder (skill-data/runner in agentuse/agentuse) into .agents/skills/runner in your project. Codex loads it when a task matches its description.

Can I use Runner 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 agentuse/agentuse --skill runner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/runner, .gemini/skills/runner, .github/skills/runner and .opencode/skills/runner in your project.

What does Runner need to run?

SKILL.md names no scripts, command-line tools or credentials: Runner is instructions for the agent only.

Does Runner access the network?

SKILL.md names 1 domain. As links in the text: docs.agentuse.io. This is read from the text; nothing was executed.

Is Runner 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 Runner use?

Runner has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Runner use?

About 1k tokens (SKILL.md is roughly 4.1k 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 Runner?

Skills that share tags, products or a category with Runner: Agent Test Long Runner (ruvnet/ruflo, 74k stars), Add Runner Eval (paperclipai/paperclip, 98k stars), Pytest Runner (saleor/saleor, 23k stars) and Twenty Entity Runner Actions (twentyhq/twenty, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Runner?

agentuse (a GitHub organization) maintains it in agentuse/agentuse, which has 205 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

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