agent-setup

Automates configuration of pi-side-agents lifecycle tooling for child agents.

188|18|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/pasky/pi-side-agents --skill agent-setup-pasky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-setup
Source: https://github.com/pasky/pi-side-agents/tree/main/skills/agent-setup
Command: npx skills add https://github.com/pasky/pi-side-agents --skill agent-setup-pasky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize and standardize the setup for pi-side-agents that spawn and manage asynchronous child agents from a main session.

Core Features & Use Cases

  • Phase-based setup workflow: interviews to collect project-specific bootstrap choices, then generate runtime configuration under .pi/side-agents, and provide a ready-to-use finish and start scripts.
  • Local-only configuration discipline: ensures .pi/ files remain runtime/local and are not tracked by Git.
  • Upgrade and maintenance: supports upgrading the agent setup with diffs and backups for safe updates.

Quick Start

Run the agent-setup skill to scaffold the lifecycle scripts and then run it again to apply updates as needed.

Frequently Asked Questions about agent-setup

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

FAQPage Schema
How do I set up asynchronous child agents from a main session?

To set up asynchronous child agents, this Skill automates initial configuration by interviewing you for project-specific choices and generating deterministic bootstrap scripts and runtime files under .pi/side-agents.

Can I keep pi-side-agents lifecycle configuration files untracked by Git?

Yes, you can keep pi-side-agents configuration files untracked by Git. This Skill imposes a local-only file handling discipline, ensuring .pi/ runtime configurations remain local and are never committed to version control.

What is the best way to upgrade local runtime files for asynchronous agents?

The best way to upgrade local runtime files for asynchronous agents is to run the agent-setup Skill again. It applies updates safely by providing diffs and backups for ongoing maintenance of your lifecycle tooling.

Does pi-side-agents setup support finish and PR workflows?

Yes, pi-side-agents setup supports finish and PR workflows. It generates ready-to-use finish scripts that allow you to optionally complete tasks and submit pull requests directly from the spawned child agents.

When do I need to scaffold lifecycle scripts for spawned child agents?

You need to scaffold lifecycle scripts for spawned child agents when starting new projects or maintaining ongoing ones. It standardizes the control and execution of asynchronous agents from a main session.

How does the agent-setup interview process work for new projects?

The agent-setup interview process works by asking phase-based questions to collect your project-specific bootstrap choices. It uses your answers to generate deterministic runtime configuration and ready-to-use start scripts under .pi/.