An automation skill for AI agents to organize, execute, document, and troubleshoot terminal-based Python scripts using standardized end-of-file metadata.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pyscripts-org
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pyscripts-org using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is pyscripts-org?
pyscripts-org is a robust framework designed for AI coding agents to manage, run, and document terminal Python scripts dynamically. By maintaining structured summary blocks directly at the end of each script, AI agents can rapidly index and discover existing tools. This prevents the redundant creation of code and establishes a highly organized local environment.
Integrating this skill with your agent via Openclaw Skills ensures seamless workflow automation. The agent continuously learns from runtime errors by maintaining a centralized pitfall log, significantly improving self-healing capabilities and script reliability over time.
pyscripts-org Use Cases
- When an AI agent needs to write, run, or modify a Python utility script.
- When preventing duplicate scripts is necessary by first checking a central index.
- When documenting and indexing localized python automation tools automatically.
- When debugging script execution failures and ensuring the agent records the solution to prevent future errors.
How pyscripts-org Works
- Check Index: The agent reads the local pyscripts_docs.md index file to find an existing script matching the requested functionality.
- Execute or Create: If a script exists, the agent runs it. If not, the agent creates a new script and places a mandatory summary block at the absolute end of the file.
- Handle Failures: If execution fails, the agent reads the code, fixes the bug, and logs the root cause in pyscripts_pitfall.md.
- Update Documentation: The agent runs summary.py to parse all scripts, extract their summaries, and automatically rebuild the pyscripts_docs.md documentation table.
pyscripts-org Setup
To install and configure the pyscripts-org skill from the repository of Openclaw Skills, follow these quick steps:
- Save the primary
summary.pyscript to your workspace root directory. - Ensure your AI agent has read/write permissions for the workspace.
- Verify your Python environment is set up by running the tool directly:
python summary.py
- Instruct your agent to strictly adhere to the workflow of checking
pyscripts_docs.mdbefore writing new Python code.
pyscripts-org Data Schema & Taxonomy
Script Summary Block Format
Every Python file must conclude with the following block at the very end of the file:
# ===== SUMMARY =====
# Brief description of what the script does and when to use it.
# Syntax: python script.py <args>
# ===== END SUMMARY =====
Document Index Schema (pyscripts_docs.md)
| Column | Description |
|---|---|
| Script | The relative path to the Python script file. |
| Summary | Extracted explanation of functionality. |
| Syntax | The correct CLI invocation string. |
Pitfall Log Schema (pyscripts_pitfall.md)
### Error: [script name] - [short description]
- Cause: [Reason for the failure]
- Fix: [Action taken to resolve the issue]
- Date encountered: [YYYY-MM-DD]
pyscripts-org Advanced Features
- Automated Self-Documentation: Running summary.py dynamically parses all files and automatically maintains pyscripts_docs.md with zero manual overhead.
- Error Pitfall Ledger: The manual error recording in pyscripts_pitfall.md empowers the agent with long-term memory to prevent repeating coding errors.
- Stand-alone Executables: Unlike fleeting code executions, this skill keeps scripts clean, modular, and permanently reusable as CLI tools within the Openclaw Skills suite.
SKILL.md
Loading
Related Openclaw Skills
#NeverAgain Movement Startup Toolkit
A digital movement-startup toolkit that empowers students and survivors to organize protests, build digital campaigns, and advocate for legislative change.
The Black Church Exploration & Education Toolkit
An executable AI agent toolkit based on Henry Louis Gates Jr.'s work, exploring how the Black Church shaped American history, music, and civil rights.
GIRLBOSS Sophia Amoruso Startup Playbook
An executable AI agent toolkit inspired by Sophia Amoruso's #GIRLBOSS, designed to guide founders through bootstrapping, brand curation, and business growth.
The Truths We Hold
An executable AI coding agent skill translating Kamala Harris' memoir into actionable leadership, legal advocacy, and crisis-response workflows.
His Truth Is Marching On
An executable AI skill inspired by Jon Meacham's book, designed to guide users through nonviolent advocacy, persistent hope, and social justice framework of John Lewis.
Walking with the Wind: Civil Rights Activism & Leadership Toolkit
An executable AI-powered toolkit based on John Lewis's legendary memoir to teach moral leadership, nonviolent protest, and community building.
Featured*
