← Back to Skills Marketplace
The Semantic Handshake Engine
by
MilesXiang
· GitHub ↗
· v1.0.0
· MIT-0
144
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install s2-nlp-connector
Description
Generates executable device control templates from API docs using local LLMs to enable cross-protocol IoT device management respecting closed ecosystem restr...
Usage Guidance
This skill appears coherent with its stated purpose, but follow these precautions before installing/using it: 1) Only run it against a trusted local LLM endpoint — the code POSTS the raw prompt (including whatever API doc you provide) to http://localhost:1234/v1; if that endpoint is malicious or configured to forward requests, your inputs could leak. 2) Do not paste secrets (API keys, tokens, private endpoints) into the 'API/Protocol Doc' prompt — the skill will send those verbatim to the model and store the resulting adapter in ./s2_primitive_data/active_hardware_mounts.json. 3) Inspect and sandbox the skill (run in an isolated environment) if you are unsure about its provenance; the package metadata lists space2.world but source is unknown. 4) If you plan to integrate proprietary hardware, note the code enforces a 'BLOCKED_CLOSED_ECOSYSTEM' policy and will instruct you to use official bridges (Matter/Home Assistant) rather than attempting cryptographic bypass. 5) If you need higher assurance, request signed provenance or a reproducible build from the author; absent that, treat the unknown source as a reason for caution.
Capability Analysis
Package: s2-nlp-connector (xpi)
Version: 1.0.0
Description:
The s2-nlp-connector package is a CLI utility designed to generate IoT device configuration templates (adapters) by interfacing with a local LLM API. The code collects device metadata and API documentation from the user, sends it to a local endpoint (http://localhost:1234), and saves the resulting JSON structure to a local directory. There is no evidence of malicious behavior such as credential exfiltration, execution of arbitrary shells, or unauthorized network communication outside of the specified local LLM integration.
Capability Assessment
Purpose & Capability
Name/description (dynamic API adapter generation for IoT) aligns with what the skill does: it prompts an LLM to produce JSON control templates and then stores the adapter. There are no unrelated requirements (no cloud credentials, no unrelated binaries).
Instruction Scope
SKILL.md and skill.py both instruct the agent to send the entire provided API/protocol doc to an LLM and expect a JSON adapter. This stays within the declared purpose, but the skill will forward any content you enter (including possible embedded keys or secrets) to the model; the SKILL does not redact secrets or limit what is included in the prompt.
Install Mechanism
There is no install spec and no packages downloaded. The skill is provided as a code file and runs with standard library modules only (urllib, json, os), which is proportionate to its functionality.
Credentials
The skill requires no environment variables, credentials, or config paths. It does create and write to a local directory (./s2_primitive_data) to persist adapters and mounts — this storage is explained by the skill's purpose but may contain sensitive data depending on what you input.
Persistence & Privilege
always:false and user-invocable:true (normal). The skill persists adapter/mount metadata to a local file (active_hardware_mounts.json) but does not change other skills or system-wide settings. It does not grant itself elevated platform privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install s2-nlp-connector - After installation, invoke the skill by name or use
/s2-nlp-connector - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
S2-NLP-Connector v1.0.0
- Introduces a dynamic API adapter generator that reads device API documentation and creates executable Declarative Control Templates.
- Implements a three-tier integration architecture to handle devices with native S2 JSON support, open APIs, and closed proprietary protocols.
- Automatically generates adapters for open API devices; securely blocks direct access to closed ecosystems, enforcing use of approved bridges.
- Provides bilingual (English/中文) documentation and simulation examples for easy understanding and testing.
Metadata
Frequently Asked Questions
What is The Semantic Handshake Engine?
Generates executable device control templates from API docs using local LLMs to enable cross-protocol IoT device management respecting closed ecosystem restr... It is an AI Agent Skill for Claude Code / OpenClaw, with 144 downloads so far.
How do I install The Semantic Handshake Engine?
Run "/install s2-nlp-connector" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is The Semantic Handshake Engine free?
Yes, The Semantic Handshake Engine is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does The Semantic Handshake Engine support?
The Semantic Handshake Engine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created The Semantic Handshake Engine?
It is built and maintained by MilesXiang (@spacesq); the current version is v1.0.0.
More Skills