An agent-neutral skill for safely coordinating trusted coding agents through a configured Paseo Streamable HTTP MCP server. It adds durable repository and workspace aliases to Paseo's native workspaces, worktrees, agents, and activity records without introducing a private bridge or SDK dependency.
skills/paseo-agent-orchestration/ is an Agent Skills-compatible
package. Its core workflow is independent of a particular agent runtime:
- use the native MCP tools exposed by the configured Paseo connection;
- resolve repository and workspace aliases exactly;
- create worktree-backed workspaces and one primary agent safely;
- preflight agent state before sending a follow-up; and
- preserve native IDs for recovery and auditability.
It deliberately does not include a daemon URL, authentication material, repository paths, aliases, or an agent-client configuration. Those are deployment-owned inputs.
Install the skills/paseo-agent-orchestration directory using your client's
Agent Skills mechanism, then configure that client with an authorized native
Paseo MCP server. The skill uses the tool names and schemas that the client
exposes for that server; it never falls back to shell commands, private Paseo
imports, or a separate orchestration bridge.
Provide a trusted, read-only alias configuration using the documented schema in examples/repositories.json. Do not commit the real configuration to this repository.
For a Hermes deployment, see docs/integrations/hermes.md. It is an adapter guide only; the installed skill remains portable.
The skill requires exact aliases and uses native IDs as the recovery path. It
does not fuzzy-match repository names, dynamically register paths, select an
ambiguous agent, approve permissions, or autonomously choose full-access.
It also avoids destructive lifecycle operations such as canceling, archiving,
killing, or relabeling agents.
Validate the skill folder with the Agent Skills validator supplied by your client or with an equivalent frontmatter validator before release. Keep host-specific alias maps and credentials outside version control.