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>".
pinned to #33f032dupdated 2 weeks ago
Ask your AI client: “install skills/agent-job-background”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/agent-job-backgroundmetahub onboarded this repo on the author's behalf.
If you own github.com/stephengpope/thepopebot on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
1,845
Last commit
2 weeks ago
Latest release
published
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.33f032d· 2 weeks ago
Documentation
41Description quality
55 words · 312 chars — "Use to spawn or check on long-running background agent jobs (each launches a new…"
README is present and substantial
13,517 chars · 9 sections · 8 code blocks
Tags / topics declaredwarn
No manifest tags and no GitHub repo topics
Add tags to the manifest (or GitHub topics on the repo) so the registry's search and category filters surface this artifact.
README has usage / example sections
no labeled section but 8 code blocks document usage
Homepage / docs URL declared
https://skool.com/ai-architects
Release history
1- releasecurrent33f032dwarn2 weeks ago
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, andUSER_IDare injected automatically — no setup required.- The spawned job inherits
USER_IDfrom the env if set, so it's attributed to the same originator as this chat/job.
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/agent-job-background