openclaw-add-script

Scaffolds shell scripts with strict mode, shared JSON response helpers, and agent tool documentation.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-add-script-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-add-script
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/openclaw-skills/skills/openclaw-add-script
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-add-script-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq.

What problem does it solve? Manually writing automation scripts for agents leads to inconsistent output formats, silent failures from missing strict shell flags, and duplicated helper code. This Skill standardizes script scaffolding so every script emits parseable JSON, logs to stderr, and follows a shared structure. ## Core Features & Use Cases - Script Scaffolding: Generates executable bash scripts with set -euo pipefail, a shared json-response.sh helper, and correct stdout/stderr separation. - Naming Enforcement: Validates lowercase-hyphen script names and enforces the scripts/lib/json-response.sh shared helper path. - Documentation Integration: Automatically appends the new script to the agent's TOOLS.md file. - Use Case: When adding a new automation script to an agent's scripts/ directory, use this Skill to generate a compliant skeleton, then implement the logic knowing the output contract is already enforced. ## Quick Start Ask the agent to add a new script named 'sync-data' for your agent, and it will scaffold the script, shared JSON helper, and TOOLS.md entry for you.

Frequently Asked Questions about openclaw-add-script

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a shell script that outputs JSON for an agent?

Scaffold the script with strict mode using set -euo pipefail, source a shared json-response.sh helper, and print exactly one JSON object to stdout. Send all log messages to stderr so JSON consumers can parse the output reliably.

How to enforce naming conventions for agent automation scripts?

Validate script names against the regex ^[a-z0-9]+(-[a-z0-9]+)*$ before creating files. This guarantees lowercase-hyphen names and produces filenames in the format <script_name>.sh.

Why does my shell script fail silently without strict mode?

Without set -euo pipefail, bash continues after command failures, treats unset variables as empty strings, and hides pipeline errors. Enabling strict mode surfaces these bugs immediately instead of producing corrupted output.

Can I print logs to stdout in a JSON-emitting script?

No, stdout must contain only the single JSON result object. Route all log messages to stderr so tools like jq can parse stdout without interference from log lines.

What are the limitations of scaffolded script templates?

The generated script contains placeholder logic returning a not-implemented status. You must implement the actual behavior, add tests if needed, and keep the shared helper centralized rather than duplicating it per script.