heterogeneous-agent
Implement or debug LobeHub heterogeneous agents. Use for Claude Code/Codex adapters, external CLI agents, event mapping, IPC, persistence, tool-call chains, sessions, traces, or adapter bugs.
Profile →npx skills add lobehub/lobehub --skill heterogeneous-agent --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Heterogeneous Agent Development Use this skill when the bug or feature lives in the external CLI agent pipeline, not the normal server-side agent runtime. ## Use This Skill For - Adding or changing a driver under `apps/desktop/src/main/modules/heterogeneousAgent/drivers/` - Editing an adapter under `packages/heterogeneous-agents/src/adapters/` - Debugging `heteroAgentRawLine` transport, `window.__HETERO_AGENT_TRACE`, or `executeHeterogeneousAgent` - Fixing Claude Code stream-json bugs such as duplicate partial/full chunks, broken `message.id` boundaries, missing `tool_result`, TodoWrite state drift, or subagent thread routing - Fixing Codex JSONL bugs such as mixed multi-tool messages, broken turn boundaries, or missing tool-result mapping - Fixing step-boundary, tool persistence, subagent thread, or resume bugs in Claude Code / Codex flows - Reproducing multi-tool mixing, orphan tool messages, or stuck tool-result loading ## Pipeline Map 1. CLI raw stdout / JSONL 2. Electron main spawns the CLI and broadcasts `heteroAgentRawLine` 3. Adapter maps raw provider events into `HeterogeneousAgentEvent` 4. `executeHeterogeneousAgent` persists assistant/tool messages and forwards stream
- Use This Skill For
- Pipeline Map
- Read These Files First
- Default Debug Order
- Critical Invariants
- Common Bug Patterns
- References
What does the heterogeneous-agent skill do?
Implement or debug LobeHub heterogeneous agents. Use for Claude Code/Codex adapters, external CLI agents, event mapping, IPC, persistence, tool-call chains, sessions, traces, or adapter bugs.
How do I install it?
Run `npx skills add lobehub/lobehub --skill heterogeneous-agent --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From lobehub/lobehub, a repository with 81,252 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.