skills.rest
igamenovoer
igamenovoerCOMMUNITY
Explore all skills by this author →
GitHub

houmao-agent-instance

Manage Houmao agent instance lifecycle operations via houmao-mgr.

18|3|Updated Mar 5, 2026
Search Tags:#cleanup#tmux#agent lifecycle#cli orchestration#managed agents#agent instance management#houmao-mgr
One-click install
npx skills add https://github.com/igamenovoer/houmao --skill houmao-agent-instance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: houmao-agent-instance
Source: https://github.com/igamenovoer/houmao/tree/main/src/houmao/agents/assets/system_skills/houmao-agent-instance
Command: npx skills add https://github.com/igamenovoer/houmao --skill houmao-agent-instance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Houmao's managed-agent lifecycle management is hard to operate correctly by hand, and this skill provides a single canonical way to launch, join, list, stop, relaunch, and clean up live agent instances via houmao-mgr.

Core Features & Use Cases

  • Launch managed-agent instances from roles, presets, raw profiles, or specialists using Houmao-supported lifecycle lanes.
  • Adopt running provider sessions through join so an existing supported provider process becomes controlled by Houmao.
  • Lifecycle operations with safety guardrails including listing current instances, stopping, relaunching tmux-backed surfaces, and cleaning stopped-session artifacts (session envelopes and/or logs).
  • Use cases: starting a team from predefined specialists, resuming a long-running agent workflow via relaunch, or removing stopped-session leftovers after iterations.

Quick Start

Use the houmao-agent-instance skill to stop a live managed agent named "demo-writer" in this workspace.

Frequently Asked Questions about houmao-agent-instance

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

FAQPage Schema
How do I manage live agent lifecycles using tmux and cli orchestration?▼

You can manage live agent lifecycles by using houmao-mgr to launch, join, list, stop, relaunch, and clean up managed agent instances with tmux-backed session support.

What is the best way to launch managed agent instances from predefined roles?▼

Launching managed agent instances from roles, presets, raw profiles, or specialists is handled through Houmao-supported lifecycle lanes via houmao-mgr, providing a single canonical method for instance creation.

Can I adopt an existing running provider session into Houmao agent instance management?▼

Yes, you can adopt running provider sessions through the join operation, allowing an existing supported provider process to become controlled by Houmao's managed agent lifecycle.

How do I clean up stopped session envelopes and logs after agent iterations?▼

Cleaning up stopped-session artifacts is done by selecting the cleanup lifecycle action in houmao-mgr, which removes leftover session envelopes and logs from stopped managed agent instances.

Does agent instance management require a specific launcher resolution strategy?▼

Agent instance management requires a launcher resolution strategy for houmao-mgr that uses PATH-first lookup with a uv-managed fallback to route to exactly one action page.

Can I relaunch tmux-backed agent instances after they are stopped?▼

Yes, relaunching tmux-backed agent instances revives stopped or long-running agent workflows, resuming surfaces through Houmao's lifecycle operations with safety guardrails.

Related Skills

Explore More Software Engineering Skills→
igamenovoerigamenovoer
18

houmao-agent-definition

Route user intent to Houmao agent-definition management subcommands.

Community
Advanced
PranavNagrechaPranavNagrecha
2

admin-playbooks

Automate Salesforce admin routines with predefined playbooks for org checks and audits.

Community
Advanced
kcns008kcns008
5

tmux

Control tmux sessions and panes for interactive CLI workflows.

Community
Intermediate
OrinksOrinks
24

team

Orchestrate OMX team execution across tmux panes with durable state management.

Community
Advanced