stephengpope/agent-job-background
templates/skills-library/agent-job-background/SKILL.md
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>".
$ install --global
skillsauthnpx skillsauth add stephengpope/thepopebot agent-job-backgroundInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 6:29 AM153.2s2 files scanned
SKILL.md
- name:
- agent-job-background
- description:
- 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>".
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.
Related Skills
stephengpope/playwright-cli
tools
VerifiedTrustedCommunity
Automate browser interactions, test web pages and work with Playwright tests.
1,766SKILL.mdUpdated May 7, 2026
stephengpope/agent-job-secrets
development
VerifiedTrustedCommunity
Use to list or retrieve agent job secrets, API keys, and OAuth credentials (auto-refreshed). Trigger when the user mentions a secret/credential by name, or asks "what secrets are available", "get the X token", "fetch the Y API key", or when a previously-fetched credential stops working and needs to be re-fetched.
1,766SKILL.mdUpdated May 7, 2026
stephengpope/agent-job-dm
testing
VerifiedTrustedCommunity
Send a direct message to a user OR broadcast to all subscribed admins via their default channel (currently Telegram). Also looks up users when a specific person is named. Trigger when the user says "let me know when…", "DM me", "send X to <name>", "tell <name> that…", "notify the admins", "alert everyone", "broadcast this", "let the team know", "tell all admins", or asks "who are the users?", "list users".
1,766SKILL.mdUpdated May 7, 2026
stephengpope/agent-job-dm
testing
VerifiedTrustedCommunity
Send a direct message to a user OR broadcast to all subscribed admins via their default channel (currently Telegram). Also looks up users when a specific person is named. Trigger when the user says "let me know when…", "DM me", "send X to <name>", "tell <name> that…", "notify the admins", "alert everyone", "broadcast this", "let the team know", "tell all admins", or asks "who are the users?", "list users".
1,750SKILL.mdUpdated Apr 29, 2026