- Home
- Skills
- Workflow Automation
- Background Task Scheduler
Works with the AI Agents you already use
Background Task Scheduler
Local background task scheduler with L0-L3 permissions, staged orchestration, and built-in resilient downloaders.
Free
Background Task Scheduler
Example session with this skill installed
Submit a plan to lint and test the project. Lint must finish before unit and e2e tests start in parallel. e2e depends on unit. Set level to L1.
- Read your context and instructions
- Compiled the background task scheduler
The plan has been successfully materialized and submitted. It is currently in a pending state, waiting for the first execution trigger.
Plan Materialization: ci-pipeline-a1
{
"plan_id": "ci-pipeline-a1",
"status": "pending",
"directory": ".bts/schedules/ci-pipeline/plans/ci-pipeline-a1",
"structure": {
"stages": [
{
"id": "lint_stage",
"mode": "serial",
"steps": ["eslint"]
},
{
"id": "test_stage",
"mode": "parallel",
"steps": ["unit_test", "e2e_test"]
}
]
},
"dependency_graph": {
"e2e_test": ["unit_test"]
},
"commands": {
"eslint": "npm run lint",
"unit_test": "npm run test:unit",
"e2e_test": "npm run test:e2e"
}
}
Next steps
- Start the execution by running
python scripts/bts_plan.py run_plan ci-pipeline-a1. - Monitor progress and check for any L1 approval requirements using
python scripts/bts.py list --status pending. - View real-time logs for specific steps using
python scripts/bts.py show <task_id> --lines 20.
Connects securely to your tools. The creator never sees your data.
About this skill
Long-running commands often stall agent workflows or fail silently without a trace. This skill provides a local, daemon-less background task scheduler that moves execution out of the chat turn while maintaining strict control. It handles staged orchestration with dependency management, automatic retries, and a multi-tier permission system.
What it does
- Background Execution Offloads time-intensive tasks like builds, training, or batch processing to detached local processes.
- Staged Orchestration Groups commands into Stages with serial or parallel execution modes and intra-stage
depends_onlogic. - Permission Gates Enforces L0-L3 security tiers, requiring explicit human approval for high-risk commands.
- Automated Downloads Manages HTTP(S) and BitTorrent (via aria2c) transfers with resume support, integrity checks, and rate limiting.
- Resilient Scheduling Runs recurring plans on fixed intervals with stall detection and failure propagation.
- Post-Hook Processing Triggers automatic encoding conversion via
@enchooks upon successful command completion.
How it works
- Create Tasks Use
bts.py createorpackto register single commands or batches with specific permission levels and timeouts. - Submit Plans Define multi-step sequences in a
plan.jsonfile and submit them for one-time or recurring execution. - Approve & Run Review pending approvals via
bts.py approvethen trigger execution withrunorrun_plan. - Monitor State Poll for updates using
check,show, oreventsto track logs, exit codes, and process snapshots.
Frameworks & tools
Built for Python 3 environments using standard libraries. Optional integration with aria2c for torrent functionality. State is managed via a local .bts filesystem directory (JSON/JSONL).
Why this beats prompting it yourself
Prompting an agent to "run this in the background" usually results in fragile shell scripts that die when the session ends or lack error handling. This skill provides a structured state machine with file-based persistence, ensuring tasks survive agent crashes and failures are properly logged for audit.
Use cases
- Running long-duration CI/CD pipelines or test suites locally.
- Scheduling recurring web scraping or system health checks.
- Orchestrating multi-step deployments that require manual approval gates.
- Managing large-scale file downloads with bandwidth constraints and auto-retry.
Known limitations
Requires manual polling via check commands to advance state as there is no persistent background daemon. Only supports single-machine file-based locking, not distributed systems.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Workflow Automation.
No background daemon; requires polling to drive schedules. Single-machine file locks only. Identity levels are declarative. aria2c required for torrents. No generic post-hooks besides @enc.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 10 days ago
- Free with an Agensi account
- Software
Python
Gitaria2c