pr-ship for Openclaw

A pre-ship risk assessment tool that analyzes codebase impact and version-specific constraints for OpenClaw pull requests.

glucksberg
v1.0.13
Mar 4, 2026
0
1.8k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install pr-ship

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install pr-ship 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 pr-ship?

The pr-ship skill is a specialized diagnostic tool designed for developers working on the OpenClaw repository. It functions by dynamically exploring the codebase to evaluate module risk, blast radius, and potential regressions before a pull request is merged. By integrating version-specific context and project-wide principles, it provides a comprehensive safety net for contributors.

This skill is part of the broader Openclaw Skills library, ensuring that every code change aligns with architectural standards and security philosophies. It empowers developers with evidence-backed findings, categorized by severity, to make informed decisions without imposing rigid blocking gates.

pr-ship Use Cases

  • Assessing the blast radius of changes in critical core modules before publishing a PR.
  • Identifying version-specific gotchas and behavioral changes in the latest OpenClaw releases.
  • Ensuring PRs align with project vision, security philosophy, and architectural coupling patterns.
  • Discovering relevant tests and potential side effects using dynamic codebase exploration.

How pr-ship Works

  1. The skill loads reference layers including principles, architecture maps, and exploration playbooks.
  2. It performs a git diff between the current branch and the main branch to identify changed files and patches.
  3. It classifies changed modules into risk tiers based on structural context and consumer counts.
  4. It executes read-only exploration commands to discover the impact on the codebase.
  5. It evaluates findings against safety invariants and project guidelines to generate a detailed risk report.

pr-ship Setup

To install the skill and keep it updated with the latest OpenClaw context, run the following commands:

# Install the pr-ship skill
clawhub install pr-ship

# Update to the latest version-specific context
clawhub update pr-ship

pr-ship Data Schema & Taxonomy

The skill utilizes several markdown-based reference layers to organize its knowledge and metadata:

File Purpose
STABLE-PRINCIPLES.md Coding standards, safety invariants, and common pitfalls.
ARCHITECTURE-MAP.md Module hierarchy, risk tiers, and impact matrices.
CURRENT-CONTEXT.md Version-specific gotchas and recent behavioral changes.
EXPLORATION-PLAYBOOK.md Read-only commands for dynamic codebase investigation.
VISION-GUIDELINES.md Project policy, security philosophy, and merge guardrails.

pr-ship Advanced Features

  • Dynamic Risk Classification: Automatically calculates consumer counts to verify module sensitivity.
  • Blast Radius Discovery: Uses grep and find to trace how changes propagate through the dependency graph.
  • Severity-Based Alert Scoring: Provides a weighted risk score (1-10) for every finding to prioritize fixes.
  • Vision Alignment Checks: Automatically identifies PRs that conflict with the project's 'will not merge' list or architectural boundaries.

SKILL.md


Loading

Related Openclaw Skills

Featured*