How do I install the Agent Job Background skill?

Run npx skillmds@latest add tomevault-io/agent-job-background in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agent Job Background safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agent Job Background?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agent Job Background free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agent Job Background?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agent Job Background by tomevault-io

Name: Agent Job Background
Author: tomevault-io

Agent Job Background

Use to spawn or check on long-running background agent jobs (each launches a new Docker agent container that opens a PR when done). Trigger when the user says "create a background job", "spawn an agent", "kick off a job", "run this in the background", "check job status", or asks "what's the status of job <id>". Use when this capability is needed.

tomevault-io cc4c4ed 2 files · 2.6 KB Updated Sep 17, 2026

File contents

Usage

# Run an agent job in the background
node skills/agent-job-background/agent-job-background.js create "Update the README with installation instructions"

# With overrides
node skills/agent-job-background/agent-job-background.js create "Refactor the auth module" \
  --llm-model claude-opus-4-7 \
  --agent-backend claude-code \
  --scope agents/refactor

# Status of running jobs (all, or one by id)
node skills/agent-job-background/agent-job-background.js status
node skills/agent-job-background/agent-job-background.js status <agent_job_id>

Important: pass-through behavior for `create`

The <description> arg becomes the new job's prompt verbatim. Pass it through unchanged — do not summarize, condense, or rewrite the user's request before calling. The new job's agent reads this description directly as its task. If the user gave you a multi-paragraph spec, pass the multi-paragraph spec.

Scope inheritance

If the calling agent is running with a SCOPE env var set, create defaults the new job to that same scope. Pass --scope <value> to override, or --scope "" to clear scope on the new job.

Notes

AGENT_JOB_TOKEN, APP_URL, and USER_ID are injected automatically — no setup required.
The spawned job inherits USER_ID from the env if set, so it's attributed to the same originator as this chat/job.

Source: stephengpope/thepopebot — distributed by TomeVault.

Frequently asked questions