← Back to Skills Marketplace
spacesq

The Grid Topology & Swarm Engine

by MilesXiang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
125
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install s2-habitat-swarm
Description
Defines a 2x2m spatial grid for multi-agent control, enforcing legal command chains and enabling swarm intelligence to manage human-centric spaces efficiently.
Usage Guidance
This skill appears to implement the grid and swarm simulation it advertises, but take these precautions before installing or running it: - Inspect the local avatar file it expects: the code reads ./s2_avatar_data/avatar_identity.json (and will abort if missing). Open that file first to confirm it contains no secrets you wouldn't want exposed. The manifest did not declare this config dependency. - Run the skill from a safe directory (not your home root or system directories). It will create ./s2_swarm_data/house_topology.json in the current working directory. - Confirm provenance: manifest.homepage is space2.world and repository/source is unknown. If you don't trust the publisher, avoid running the code. - Because the skill relies on another component (s2-digital-avatar), verify what that other component produces and whether its avatar_identity.json contains private keys or tokens. This skill does not request network access, but a compromised avatar file could contain unexpected data. - Do not run as an elevated user. If you want to be extra cautious, run it inside an isolated environment (container or VM) and inspect created files afterward. If you want me to, I can: (a) show the exact fields expected in avatar_identity.json based on the code, (b) produce a safe example avatar file you can review, or (c) help search the code for any hidden network calls — though this file has no such calls.
Capability Analysis
Package: s2-habitat-swarm (xpi) Version: 1.0.0 Description: The provided code is a CLI-based simulation tool for a conceptual spatial computing framework (S2-SP-OS). It manages local JSON configuration files to define room topologies and simulates agent orchestration through console output. The script performs standard file I/O within the working directory, uses basic Python libraries (os, json, uuid), and lacks any functionality for network communication, unauthorized data exfiltration, or execution of external processes.
Capability Assessment
Purpose & Capability
The manifest, SKILL.md, and skill.py are consistent: the skill builds a house topology (2m×2m units), allocates agents, enforces an 'Avatar' authority model, and runs a local simulation. All major behaviors described in the README are implemented in code; there are no network calls or unrelated capabilities in the source.
Instruction Scope
The runtime instructions and code require an existing avatar identity file at ./s2_avatar_data/avatar_identity.json and will read/write ./s2_swarm_data/house_topology.json, but the skill metadata declared no required config paths or external prerequisites. SKILL.md mentions the Virtual Butler concept but does not formally declare this file dependency. The skill also prompts for interactive input and writes topology files into the current working directory (os.getcwd()), which could result in files being created in an unexpected location if the user runs it from an unintended folder.
Install Mechanism
No install spec, no downloads, and no external packages — it's an instruction-only skill with embedded Python code. That minimizes supply-chain risk; code runs locally and does not fetch or execute remote artifacts.
Credentials
The skill requests no environment variables or external credentials and makes no network connections. However, it implicitly depends on a local artifact (avatar_identity.json) produced by another component ('s2-digital-avatar') and writes topology data to disk. This local file dependency is not declared in requires.env or required config paths in the manifest.
Persistence & Privilege
The skill does persistent local writes only under the current working directory (creates s2_swarm_data/house_topology.json). It does not request always:true, does not modify other skills, and has no autonomous network behavior. The primary persistence is limited to its own data folder but ensure the working directory is appropriate before running.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install s2-habitat-swarm
  3. After installation, invoke the skill by name or use /s2-habitat-swarm
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
**Initial release of S2-Habitat-Swarm: The Grid Topology & Swarm Engine.** - Implements the Da Xiang Standard Unit Model, defining spatial matrices in fixed 2m x 2m units for efficient compute. - Introduces a hierarchical authority system with Avatars and Core Agents for multi-agent orchestration. - Enforces strict spatial grid allocation, focusing only on core living zones and ignoring implicit spaces for resource efficiency. - Enables cross-room agent negotiation using swarm intelligence for decentralized control. - Bilingual documentation provided (English / 中文).
Metadata
Slug s2-habitat-swarm
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is The Grid Topology & Swarm Engine?

Defines a 2x2m spatial grid for multi-agent control, enforcing legal command chains and enabling swarm intelligence to manage human-centric spaces efficiently. It is an AI Agent Skill for Claude Code / OpenClaw, with 125 downloads so far.

How do I install The Grid Topology & Swarm Engine?

Run "/install s2-habitat-swarm" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is The Grid Topology & Swarm Engine free?

Yes, The Grid Topology & Swarm Engine is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does The Grid Topology & Swarm Engine support?

The Grid Topology & Swarm Engine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created The Grid Topology & Swarm Engine?

It is built and maintained by MilesXiang (@spacesq); the current version is v1.0.0.

💬 Comments