// 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>".
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".
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.
| 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>". |
# 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>
createThe <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.
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.
AGENT_JOB_TOKEN, APP_URL, and USER_ID are injected automatically — no setup required.USER_ID from the env if set, so it's attributed to the same originator as this chat/job.