← Back to Skills Marketplace
152
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install ship-loop
Description
Run a chained build→ship→verify→notify pipeline for multi-segment feature work. Use when implementing multiple features in sequence, each as a coding agent t...
Usage Guidance
This skill appears to be what it claims: a self‑healing build→ship→verify pipeline that runs your coding agent and manipulates your git repo. Before installing or running: 1) Inspect SHIPLOOP.yml in any repository you point it at — it will execute agent_command and preflight/deploy scripts as your user. 2) Don’t run on untrusted repos. Treat SHIPLOOP.yml like a Makefile/CI config. 3) Be mindful of the agent you configure — if you supply an agent CLI that needs API keys, provide them separately and understand their privileges; avoid using example flags like '--permission-mode bypassPermissions' unless you understand the implications. 4) Note Ship Loop writes state (SQLite DB, .shiploop/metrics.json, learnings.yml) and may commit learnings.yml back into the repo — consider whether you want that file tracked. 5) The pre-scan found unicode control characters in SKILL.md; open the files in a hex-aware editor or use a tool to strip/inspect control chars to ensure there is no hidden or obfuscated content. If you want higher assurance, run the code in a disposable environment or review the repository’s Python code (shiploop/) and tests; they appear to implement the documented behavior.
Capability Analysis
Type: OpenClaw Skill
Name: ship-loop
Version: 5.0.0
The skill bundle implements an autonomous build and repair pipeline that executes arbitrary shell commands provided in a 'SHIPLOOP.yml' configuration file. While the documentation includes a security notice regarding these risks, the implementation uses high-risk patterns, specifically the use of 'eval' on configuration-derived strings in 'scripts/preflight.sh' and un-sandboxed subprocess execution in 'shiploop/preflight.py' and 'shiploop/agent.py'. These represent classic RCE vulnerabilities that could be exploited if the tool is run against an untrusted repository. No evidence of intentional malice, such as data exfiltration or backdoors, was detected.
Capability Assessment
Purpose & Capability
Name/description (Ship Loop) match the provided code, CLI, and docs. Required binaries (git, python3), the SQLite state backend, provider plugins (vercel/netlify/custom), and agent CLI integration are all consistent with a tool that runs build→ship→verify cycles and spawns repair/meta worktrees.
Instruction Scope
The SKILL.md explicitly requires running the coding agent, preflight build/lint/test commands, deploy verification, git commits, worktrees, and arbitrary custom deploy scripts defined in SHIPLOOP.yml. That scope is expected for this purpose but inherently grants the skill the ability to execute arbitrary repo-defined commands with the user's privileges; the skill does include an explicit security notice and claims temp-file prompt passing and explicit staging to reduce injection and accidental mass staging.
Install Mechanism
No install spec is provided (instruction-only for the runtime), and the repository includes Python code and docs; installing dependencies is standard (pyyaml, pydantic). Nothing in the manifest attempts to download or execute remote archives during install.
Credentials
The skill declares no required environment variables (reasonable). The docs do reference agent-specific API keys (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY) and agent CLI flags; those are external to the skill and must be provided by the user for their chosen agent. This is proportionate, but users should be aware the agent command they configure may require secrets and permissions (and the example uses a '--permission-mode bypassPermissions' flag which increases risk if used).
Persistence & Privilege
The tool writes state and metrics to disk (SQLite tars.db, .shiploop/metrics.json, learnings.yml) and commits/merges branches into the repo as part of normal operation. That persistence and repo modification is expected for a pipeline tool, but it means the skill will change your working tree and commit history — review SHIPLOOP.yml and learnings.yml behavior before running.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ship-loop - After installation, invoke the skill by name or use
/ship-loop - Provide required inputs per the skill's parameter spec and get structured output
Version History
v5.0.0
**Ship Loop v5.0.0 — Major upgrade: persistent DB backend, event-driven pipeline, verdict router, and reflective analytics.**
- Added SQLite (`tars.db`) backend for full pipeline state, event log, learnings, and usage tracking.
- Introduced event queue for robust crash recovery and auditing; CLI can now inspect event/history.
- Added a verdict router for configurable outcome→action mapping, replacing hardcoded branching.
- New reflection loop audits run history, scoring learnings and surfacing actionable recommendations.
- All state (runs, segments, learnings, cost, verdicts) is DB-backed; `SHIPLOOP.yml` is now config-only.
- New CLI commands for reflection, history, events, and advanced analytics.
v4.0.0
Council review: 5 blockers fixed (env filtering, file locking, git timeouts, security docs, integration tests) + 16 warnings (dry-run, notifications, atomic writes, agent logs, cross-platform, signal handling). 170 tests.
v2.0.1
Fix security flags: agent command now user-configured via agent_command in SHIPLOOP.yml (no more hardcoded claude binary). Added requires.bins metadata for git, bash, curl. Redirect-following fix in verify-deploy.sh.
v2.0.0
Full rewrite: preflight gates, safe staging, rollback with git tags, platform-aware deploy verification, YAML pipeline definition, configurable timeouts, crash recovery. Council-reviewed, zero BLOCKs.
Metadata
Frequently Asked Questions
What is Ship Loop?
Run a chained build→ship→verify→notify pipeline for multi-segment feature work. Use when implementing multiple features in sequence, each as a coding agent t... It is an AI Agent Skill for Claude Code / OpenClaw, with 152 downloads so far.
How do I install Ship Loop?
Run "/install ship-loop" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ship Loop free?
Yes, Ship Loop is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Ship Loop support?
Ship Loop is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ship Loop?
It is built and maintained by Fernando (@fernando-fernandez3); the current version is v5.0.0.
More Skills