← Back to Skills Marketplace
2257
Downloads
0
Stars
3
Active Installs
3
Versions
Install in OpenClaw
/install smalltalk
Description
Interact with live Smalltalk image (Cuis or Squeak). Use for evaluating Smalltalk code, browsing classes, viewing method source, defining classes/methods, querying hierarchy and categories.
Usage Guidance
What to consider before installing:
- Source review: the code is self-contained and matches the described purpose, but SKILL.md asks you to git-clone an external GitHub repo; review that repo yourself before running to ensure you trust it.
- Local VM and files: this skill starts a local Squeak VM (via xvfb-run), creates background daemons, and reads/writes image and .changes files — do not run it with images you don't trust, and be prepared for large image files to be copied into ~/smalltalk-projects.
- Remote services: explain/audit features optionally use Anthropic/OpenAI keys; only set those env vars if you accept sending method/source text to those providers.
- Persistence & cleanup: the daemon leaves sockets/pid files in /tmp and stores projects under ~/.clawdbot and ~/smalltalk-projects; stop the daemon and remove those files if you want to revoke persistence.
- Dangerous actions are explicit: commands can define/delete classes and methods in the live image. That functionality is consistent with the tool but is powerful — avoid running untrusted code or images.
If you want higher assurance, inspect the full Python sources included here, avoid cloning or running untrusted images, and only provide LLM API keys when needed.
Capability Analysis
Type: OpenClaw Skill
Name: smalltalk
Version: 1.7.0
This skill is classified as suspicious due to its high-risk capabilities, including arbitrary Smalltalk code execution (via `evaluate`, `define-class`, `define-method`, etc.) and the execution of LLM-generated Smalltalk code (in `smalltalk.py` via `tool_generate_sunit`). While these features are central to the skill's stated purpose of interacting with a live Smalltalk image, they present a significant attack surface for code injection and potential VM escape. Additionally, the `debug_squeak` function in `smalltalk.py` creates an HTML report containing screenshots and stack traces in `/tmp`, posing a local information disclosure vulnerability. The `smalltalk-daemon.py` manages a persistent VM with powerful capabilities, though it implements some security measures like user-isolated Unix sockets with restrictive permissions. The skill does not show clear evidence of intentional malicious behavior like data exfiltration to external endpoints or stealthy persistence mechanisms.
Capability Assessment
Purpose & Capability
The skill's name/description (interact with Squeak/Cuis images) matches the provided code and required binaries (python3, xvfb-run). The code manages Squeak VMs, images, .changes files, sockets and project snapshots — all consistent with a Smalltalk interaction tool. No unrelated cloud credentials or unrelated binaries are required.
Instruction Scope
The SKILL.md instructs the agent/user to clone an external GitHub repo and to start/operate a local Squeak VM (daemon or per-call exec). That network fetch and the ability to evaluate/define/delete methods in the live image are expected for this skill, but they increase risk: arbitrary Smalltalk code in an image or methods you inject can execute with the VM's privileges. The SKILL.md also documents optional explain/audit features that send source to external LLM providers (Anthropic/OpenAI) if API keys are provided — this is explicit but you should be aware that code and comments may be transmitted to those services.
Install Mechanism
There is no automated install spec (instruction-only), which is lower-risk. One inconsistency: SKILL.md tells you to 'git clone https://github.com/CorporateSmalltalkConsultingLtd/ClaudeSmalltalk.git' even though the skill package includes multiple Python scripts; the repo reference is reasonable (upstream project) but it's redundant and means a network fetch is suggested. The clone URL is a GitHub domain (not a shortener or personal IP).
Credentials
The declared and used environment variables (SQUEAK_VM_PATH, SQUEAK_IMAGE_PATH, SMALLTALK_DEV_MODE, optional ANTHROPIC_API_KEY/OPENAI_API_KEY) are appropriate for a tool that starts a VM, points to an image, and optionally calls LLM services. The skill does not request unrelated credentials. Note: LLM API keys are optional but required for explain/audit commands; if set, source code or method text may be sent to those providers.
Persistence & Privilege
The skill runs a background daemon (when invoked) and writes pid/socket files under /tmp and per-user config under ~/.clawdbot and ~/smalltalk-projects. always:false (normal). This is expected for a persistent VM helper, but you should be aware it will start background processes and can persist image/changes files when dev mode is used.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install smalltalk - After installation, invoke the skill by name or use
/smalltalk - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.7.0
**Dev mode, daemon support, and LLM code explanation/testing tools added.**
- Added support for persistent dev mode with user-supplied images and changes file.
- Introduced background daemon (`smalltalk-daemon.py`) for playground and dev workflows.
- Expanded CLI with commands for explaining code and methods, LLM-aided comment audit, class audit, and automated SUnit test generation.
- New environment variables and CLI flags for Anthropic/OpenAI LLM configuration.
- Improved method source handling, now supporting class-side methods with new syntax/flag.
- Added new documentation sections for modes, commands, and LLM-enabled workflows.
v1.0.1
Add ClaudeSmalltalk repo link to prerequisites
v1.0.0
Initial release: Squeak MCP integration with --check and --debug tools
Metadata
Frequently Asked Questions
What is Smalltalk?
Interact with live Smalltalk image (Cuis or Squeak). Use for evaluating Smalltalk code, browsing classes, viewing method source, defining classes/methods, querying hierarchy and categories. It is an AI Agent Skill for Claude Code / OpenClaw, with 2257 downloads so far.
How do I install Smalltalk?
Run "/install smalltalk" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Smalltalk free?
Yes, Smalltalk is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Smalltalk support?
Smalltalk is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Smalltalk?
It is built and maintained by johnmci (@johnmci); the current version is v1.7.0.
More Skills