← Back to Skills Marketplace
jcools1977

Proprioception

by John DeVere Cooley · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
412
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install proprioception
Description
Self-spatial awareness for AI agents. Gives your bot a real-time sixth sense of where it is relative to the user's goal, its own confidence boundaries, conve...
Usage Guidance
What to check before installing: - Review the omitted file (text-utils.js) and any other truncated/omitted files. Those utilities implement tokenization, similarity, and pattern counting — if they also include network calls, file writes, or telemetry hooks, that would change the assessment. - Double-check there are no hidden network calls or use of process.env in the full codebase. The reference doc mentions a "Data Flywheel" (collecting aggregate telemetry). That is not present in the visible scripts, but if telemetry/upload code exists elsewhere it would be unexpected for a skill that claims “zero external API calls.” - Confirm how your agent runtime executes skill code: is execution sandboxed, are filesystem and network accesses restricted? Running this skill in a restricted test environment first is prudent. - If you plan to use this in production, ask the author for provenance (who published it) and for an explicit statement about data handling (no telemetry, no uploads, no logging outside the agent). The skill is coherent with its stated purpose, but the missing file and the 'data flywheel' language are reasons to verify there's no undeclared telemetry or side effects.
Capability Analysis
Type: OpenClaw Skill Name: proprioception Version: 1.0.0 The skill's core logic, implemented in the Node.js scripts, is benign, performing local text analysis without external network calls or sensitive file access. However, the `SKILL.md` file contains an instruction for the OpenClaw agent to execute a shell command (`node "$(dirname "$SKILL_PATH")/scripts/proprioception-engine.js" --root-intent "$ROOT_INTENT" --current-response "$CURRENT_RESPONSE" ...`). This command directly interpolates agent-provided variables (`$ROOT_INTENT`, `$CURRENT_RESPONSE`, `$PRIOR_SIGNALS_JSON`) into the shell. If the OpenClaw agent platform does not properly sanitize or escape these variables before execution, a malicious user could craft inputs to achieve shell injection, leading to Remote Code Execution. This constitutes a significant vulnerability, classifying the skill as suspicious.
Capability Assessment
Purpose & Capability
Name/description, the CLI entrypoint (node script), and the sensor modules align: the package implements five local analysis sensors and a dashboard. Requiring node is coherent. However, the reference doc includes a 'Data Flywheel Potential' section describing aggregating telemetry across sessions — that capability is described but not implemented in the shown code. This is a minor inconsistency: it could be aspirational, but it raises a question about whether future/hidden code will collect or export telemetry.
Instruction Scope
SKILL.md and the scripts describe only local analysis of conversation text and producing alerts or an ASCII dashboard. The CLI interface accepts the conversation context and prior signals via arguments; there are no instructions in SKILL.md that ask the agent to read arbitrary system files, environment variables, or to call external endpoints. Based on the visible code, the runtime scope is limited to analyzing provided text.
Install Mechanism
No install spec is provided (instruction-only), which is low risk in general. However, the skill bundle contains several Node scripts that will be executed by the agent runtime (node required). Because there is no package-install step and no external download, there is no immediate network-based install risk — but the agent will execute bundled JS. Verify how your agent runtime executes skill code (sandboxing, permission model).
Credentials
The skill declares no required environment variables, no credentials, and no config paths. The visible code does not read process.env or request credentials. This is proportional to a purely local text-analysis capability.
Persistence & Privilege
Skill flags are default (not always:true), and scripts shown do not modify other skills or global agent config. The code produces output and a dashboard but does not persist data or install background services in the provided files. Confirm how the agent runtime handles skill storage and logs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install proprioception
  3. After installation, invoke the skill by name or use /proprioception
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — Self-spatial awareness for AI agents
Metadata
Slug proprioception
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Proprioception?

Self-spatial awareness for AI agents. Gives your bot a real-time sixth sense of where it is relative to the user's goal, its own confidence boundaries, conve... It is an AI Agent Skill for Claude Code / OpenClaw, with 412 downloads so far.

How do I install Proprioception?

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

Is Proprioception free?

Yes, Proprioception is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Proprioception support?

Proprioception is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Proprioception?

It is built and maintained by John DeVere Cooley (@jcools1977); the current version is v1.0.0.

💬 Comments