One-click install
npx skills add https://github.com/agentscope-ai/HiClaw --skill organization-agentscope-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: organization
Source: https://github.com/agentscope-ai/HiClaw/tree/main/manager/agent/team-leader-agent/skills/organization
Command: npx skills add https://github.com/agentscope-ai/HiClaw --skill organization-agentscope-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents incorrect assignments and lifecycle actions by ensuring the AI leader always uses the latest, authoritative HiClaw team and worker topology instead of relying on stale internal assumptions.

Core Features & Use Cases

  • Single source of truth via CLI: Pulls team, worker list, room IDs, matrix IDs, runtime/phase, and identity details from the hiclaw CLI rather than chat history or cached metadata.
  • Safe execution guardrails: Requires resolving the Team CR name before any team-scoped query, and forces a stop/report when required identifiers are missing instead of guessing.
  • Correct lifecycle orchestration: Supports recovery and operational flows such as assigning tasks, sending cross-room messages, handling heartbeat, and waking/sleeping/ensuring readiness of workers.

Quick Start

Use organization before assigning tasks or changing worker lifecycle state so the leader uses current room IDs, Matrix IDs, and worker phases from hiclaw CLI.

Frequently Asked Questions about organization

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

FAQPage Schema
How do I validate worker state and team topology before assigning tasks in HiClaw?

To validate worker state and team topology in HiClaw, use the authoritative hiclaw CLI to resolve the Kubernetes Team CR name and fetch current room IDs, Matrix IDs, and worker phases instead of relying on cached metadata.

Why does multi-agent orchestration fail when assigning tasks with stale room IDs?

Multi-agent orchestration fails with stale room IDs because leaders act on outdated assumptions. Using the hiclaw CLI ensures accurate team topology and prevents incorrect assignments by fetching the latest authoritative worker state.

What happens to worker lifecycle operations when the hiclaw CLI output is incomplete?

When hiclaw CLI output is incomplete, worker lifecycle operations stop and report the missing data. This orchestration safety guardrail refuses to guess required room or Matrix IDs, preventing invalid sleep, wake, or readiness actions.

How do I handle cross-room messaging and heartbeat events safely in a multi-agent system?

To handle cross-room messaging and heartbeat events safely, query the hiclaw CLI to validate required Matrix IDs and worker runtime phases first, ensuring the leader uses the authoritative team topology before sending messages.

When should I query the Kubernetes Team CR name before changing worker lifecycle state?

You should query the Kubernetes Team CR name before any worker lifecycle state change, such as waking, sleeping, or ensuring readiness. Resolving the Team CR name first guarantees the operation targets the correct authoritative team scope.

Can I use cached chat history for project recovery instead of querying the hiclaw CLI?

No, you should not use cached chat history for project recovery. The hiclaw CLI serves as the single source of truth for team topology and runtime state, ensuring safe execution and preventing incorrect lifecycle orchestration actions.