← Back to Skills Marketplace
z-bra0

Scratch Blocks

by Z-Bra0 · GitHub ↗ · v0.0.2 · MIT-0
cross-platform ✓ Security Clean
91
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install scratch-blocks
Description
Use this skill when the user uploads a `.sb3` or `.sprite3` file, or when the conversation is about Scratch and clearer block-style visualization would help.
Usage Guidance
This skill appears to do what it says: it will execute the included Python scripts locally to extract and render Scratch projects, and it does not request credentials or make network calls. Before installing, review that you're comfortable with the agent running those local Python scripts on user-supplied .sb3/.sprite3 files (the extractor writes to /tmp/scratchcode/<md5>/blocks.json and may leave files behind). If you are concerned about residual files, delete /tmp/scratchcode after use. If you need additional assurance, inspect the two scripts (scripts/extract.py and scripts/render_ascii.py) yourself — they use only the Python standard library and the bundled BLOCK_CATALOG, and I found no code that exfiltrates data or contacts external endpoints.
Capability Analysis
Type: OpenClaw Skill Name: scratch-blocks Version: 0.0.2 The skill bundle is designed to help an AI agent process and visualize Scratch projects (.sb3/.sprite3 files). The included Python scripts, 'extract.py' and 'render_ascii.py', perform local file operations such as unzipping archives and parsing JSON to generate ASCII representations of code blocks. There is no evidence of data exfiltration, malicious execution, or harmful prompt injection; the logic is entirely consistent with the stated purpose of providing a Scratch code assistant.
Capability Assessment
Purpose & Capability
Name/description (render Scratch projects into block-style ASCII) match the included files and scripts: extract.py converts .sb3/.sprite3/project.json to the internal scratch-json, and render_ascii.py renders that format using the bundled BLOCK_CATALOG. No unrelated binaries, env vars, or external services are requested.
Instruction Scope
SKILL.md gives explicit, constrained instructions: run scripts/extract.py for archives, produce scratch-json in /tmp, and run scripts/render_ascii.py to render output. It forbids returning scratch-json to users and requires using the renderer output. The runtime steps reference only local files and the temp output; they do not ask the agent to read other system files or contact external endpoints.
Install Mechanism
No install specification — instruction-only plus bundled Python scripts. Both scripts use only the Python standard library and local data files; nothing is downloaded or executed from external URLs.
Credentials
The skill requires no environment variables, credentials, or config paths. The scripts operate on user-provided Scratch files and local temp dirs only.
Persistence & Privilege
extract.py creates a working directory under /tmp/scratchcode/<md5>/ and writes blocks.json there (and may leave that directory). The skill is not always-enabled and does not request persistent elevated privileges or modify other skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install scratch-blocks
  3. After installation, invoke the skill by name or use /scratch-blocks
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.2
- Updated SKILL.md with detailed workflow, output contract, and internal format guidelines. - Added instructions on handling `.sb3` and `.sprite3` files, and on using internal `scratch-json` only with the designated rendering script. - Clarified that all Scratch code shown to users must be rendered using `scripts/render_ascii.py`, never raw or hand-drawn. - Provided explicit structure and usage examples for scripts, variables, lists, and block data. - Outlined best practices for how and when to display rendered Scratch blocks in user replies.
Metadata
Slug scratch-blocks
Version 0.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Scratch Blocks?

Use this skill when the user uploads a `.sb3` or `.sprite3` file, or when the conversation is about Scratch and clearer block-style visualization would help. It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.

How do I install Scratch Blocks?

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

Is Scratch Blocks free?

Yes, Scratch Blocks is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Scratch Blocks support?

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

Who created Scratch Blocks?

It is built and maintained by Z-Bra0 (@z-bra0); the current version is v0.0.2.

💬 Comments