bub

Delegate complex tasks to isolated sub-agent sessions with SKILL.md configuration.

6|Updated Mar 19, 2026

Search Tags:#automation #cli #orchestration #workflows #task-management #sub-agent #bub

Ready to run

npx skills add https://github.com/PsiACE/bub --skill bub

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bub
Source: https://github.com/PsiACE/bub/tree/main/src/bub/skills/bub
Command: npx skills add https://github.com/PsiACE/bub --skill bub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bub addresses the complexity of coordinating multiple tasks and sub-agents within engineering workflows, enabling reliable delegation and isolated execution contexts to improve predictability and recoverability.

Core Features & Use Cases

Orchestrates sub-task delegation to child agents and specialized tools.
Spawns isolated agent sessions for one-off commands or experiments.
Coordinates multiple tools and skills while preserving session state and safety constraints.
Use Case: break down a large feature into parallel subtasks and validate results in isolated runs.

Quick Start

Start Bub with a simple delegated task by executing bub run 'list project files'.

Frequently Asked Questions about bub

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I orchestrate sub-tasks and delegate work to isolated agent sessions?▼

You orchestrate sub-tasks by delegating work to sub-agents and spawning isolated child sessions, which coordinates multiple tools while preserving session state and safety constraints for reliable execution.

What is the best way to manage complex workflows that require multi-tool orchestration?▼

Multi-tool orchestration is managed by breaking down large features into parallel subtasks, delegating them to specialized tools, and validating results in isolated runs to improve predictability and recoverability.

How do I start a delegated task using the command line for workflow automation?▼

Start a delegated task by executing the command 'bub run' followed by your task string, which immediately spawns an isolated agent session to process the specified automation workflow.

Do I need a specific file structure to coordinate sub-agents and child sessions?▼

You need a mandatory SKILL.md file at the root directory containing YAML frontmatter with name and description, optionally including scripts, references, or assets for extended behavior.

When should I use isolated child sessions for task management?▼

Use isolated child sessions when running one-off commands or experiments, coordinating multiple skills, or breaking down large features into parallel subtasks that require safe session management.

Why does delegating tasks to sub-agents improve workflow predictability?▼

Delegating tasks to sub-agents improves predictability by isolating execution contexts, which prevents cross-task interference and enables reliable recovery if a specific subtask fails.