tool-skills

Manual invocation only; use when explicitly requested as `houmao-agent-loop-lite` or through a named lite loop operation to author or operate pro-shaped Markdown/direct-SQL loop packages with typed Markdown templates, generated skills, and direct SQLite state, without JSON schemas, Jinja2, generated harnesses, or generated docs layers.

Manual invocation only; use only when the user explicitly requests `houmao-agent-loop-pro` or an explicitly named pro loop operation to init editable loop-dir/intention material, generate or validate topology-aware loop-dir/execplan contracts, or execute a generated loop through authoring and execution subskills.

Use Houmao's canonical pre-launch agent-definition skill through explicit subcommands for roles, recipes, launch-dossiers, specialists, profiles, create-agent-fast-forward, launch-agent, and stop-agent.

Use Houmao's supported managed-agent lifecycle commands to launch, join, list, stop, relaunch, or clean up live agent instances created from predefined roles, presets, launch dossiers, or specialists.

Use Houmao's supported messaging and control surfaces to communicate with already-running managed agents through prompt, interrupt, gateway, raw-input, mailbox routing, or reset-context workflows, preferring live gateway-backed delivery when available.

Use Houmao's supported credential workflow to list, inspect, add, update, log in, rename, or remove credentials for a Houmao project or an internal native-agent root.

Manual invocation only; use only when the user explicitly requests `houmao-operator-messaging` or an explicitly named operator messaging operation to clarify operator intent and dispatch messages to one or more Houmao-managed agents by direct prompt or mailbox.

Use Houmao's manual guided touring skill for users not yet familiar with Houmao.

Use the Houmao graphing extension to author built-in AG-UI graphing payloads with Plotly.js templated graphics or Vega-Lite freeform graphics, validate them, and render standard AG-UI event batches. Use when Codex needs to create, repair, validate, or render Houmao `templated-graphics` or `freeform-graphics` charts, inspect supported Plotly trace types, choose between Plotly.js and Vega-Lite graphing layers, or prepare graphics for later Houmao gateway publishing.

Use Houmao AG-UI interop helpers for standard AG-UI event validation, event framing, generic tool-call rendering, Houmao implementation validation/rendering, and Houmao gateway publishing. Use when Codex needs to validate, frame, render, publish, route, or interpret AG-UI event batches for already-chosen Houmao implementation payloads, tables, metric grids, dashboards, or frontend-specific GUI messages.

Use Houmao's advanced-usage pattern skill for supported multi-step workflow compositions such as self-notification, notifier-prompt-driven mail loops, local-close edge loops, and forward relay loops built from existing Houmao skills.

Use Houmao's unified email communication skill for operator-origin mailbox posts, shared mailbox operations, gateway-backed `/v1/mail/*` work, transport-local context, and no-gateway fallback.

Use Houmao's supported gateway lifecycle and gateway-only control surfaces to attach, discover, operate, and inspect a live managed-agent gateway, including reminders and mail-notifier behavior.

Use Houmao's supported read-only inspection surfaces to inspect Houmao-managed agents, including liveness, TUI state, mailbox posture, runtime artifacts, logs, and tmux inspection once the session name is identified.

Use Houmao's mailbox-administration skill for filesystem mailbox roots, project mailbox roots, and late local managed-agent mailbox binding.

Use when the user's intent is to read or write a Houmao-managed agent's `houmao-memo.md` file or a reusable profile's Houmao memo seed. Necessary trigger: `memo` is mentioned. Sufficient trigger: the prompt or context says `houmao memo`, says `agent memo` where the agent clearly refers to a Houmao-managed agent, or asks for an easy/launch dossier memo seed. An explicit reference to `houmao-memo.md` is a very strong hint to call this skill.

Use Houmao's round-oriented workflow for processing gateway-notified open inbox mail through a prompt-provided gateway base URL, gateway-API-first triage, selective inspection, post-success archive behavior, and stop-after-round discipline.

Use Houmao's project-management skill for project overlay lifecycle, `.houmao/` layout, project-aware command effects, and project-scoped managed-agent inspection or stop workflows.

Compatibility wrapper. Route specialist, profile, create-agent-fast-forward, launch-agent, and stop-agent work to the canonical `houmao-agent-definition` skill.

Use Houmao's independent workspace manager skill to plan, create, validate, or summarize multi-agent workspaces, including untracked in-repo task workspaces, out-of-repo workspaces, Git worktrees, local-state links, tracked submodule materialization, launch-profile cwd updates, and optional memo-seed workspace rules. Use when the user asks to prepare, organize, inspect, dry-run, validate, or summarize a Houmao-standard workspace before launching agents.

Build and maintain a Karpathy-style LLM knowledge base and deploy its bundled local web viewer. Use when (1) scaffolding a new knowledge base for any research topic, (2) ingesting articles/papers/PDFs/web pages into raw/, (3) compiling or restructuring wiki articles from existing raw material, (4) answering questions against the wiki and filing durable answers back, (5) running lint passes for dead links / orphan pages / coverage gaps / audit shape, (6) processing human feedback from the audit/ directory and applying corrections, (7) deploying or launching the packaged web viewer against an existing LLM Wiki. Not for general note-taking, daily journals, or non-wiki Obsidian use.