PR + Commit Workflow for Openclaw

A specialized skill designed to enforce high-signal, human-verified commit and pull request workflows within AI-driven development environments.

joshp123
v1.0.0
Jan 11, 2026
0
4.1k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install pr-commit-workflow

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-commit-workflow 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 + Commit Workflow?

The PR + Commit Workflow skill ensures that AI agents maintain high standards of documentation and accountability during the development lifecycle. It acts as a bridge between agentic automation and human oversight by mandating human-written intent for every pull request, preventing the common pitfall of AI-generated fluff in version control history. By utilizing this within the Openclaw Skills ecosystem, teams can maintain a source of truth that is easily reviewable by both humans and other agents.

This skill provides a structured decision tree for choosing between commit-only tasks and full pull request lifecycles. It integrates seamlessly with existing repository-specific rules and utilizes local scripts to gather environment metadata, ensuring every PR body contains evidence-based history and intent capture.

PR + Commit Workflow Use Cases

  • Enforcing standardized commit message formats during agentic coding sessions.
  • Capturing authentic human intent for pull requests to ensure high-quality reviews.
  • Automating the collection of environment metadata for PR body history sections.
  • Standardizing evidence and checklist requirements for every code change.

How PR + Commit Workflow Works

  1. The agent analyzes the task to determine if it requires a simple commit or a full pull request based on the internal workflow decision tree.
  2. It consults local repository rules like AGENTS.md or PROCESS.md to ensure compliance with specific project standards.
  3. For commits, it applies the standardized formatting and evidence expectations defined in the workflow-commit reference.
  4. For PRs, the agent prompts the user for human-written intent, ensuring no auto-generated text replaces human reasoning.
  5. It generates a PR body draft in /tmp using a verbatim template and metadata gathered from the environment via scripts.
  6. Finally, it uses the GitHub CLI to create or edit the PR with the structured body file.

PR + Commit Workflow Setup

To integrate this workflow into your Openclaw Skills environment, ensure your repository contains the required reference documents and helper scripts.

# Ensure GitHub CLI is installed and authenticated
gh auth status

# Verify the presence of mandatory workflow references
ls references/workflow-commit.md references/workflow-pr.md

# Make the metadata collector script executable
chmod +x scripts/build_pr_body.sh

PR + Commit Workflow Data Schema & Taxonomy

This skill organizes its lifecycle data through a combination of temporary files and markdown templates to maintain high-signal output within Openclaw Skills.

Data Component Purpose
/tmp/ Temporary storage for PR body drafts and intent capture.
references/pr-human-template.md The verbatim structure for all Pull Request descriptions.
references/commit-format.md Defines the specific schema for high-signal commit messages.
scripts/build_pr_body.sh Script that aggregates environment metadata into the PR history.

PR + Commit Workflow Advanced Features

  • Multi-agent compatibility through standardized AGENTS.md and PROCESS.md rule ingestion.
  • Automatic evidence gathering via the build_pr_body metadata collection script.
  • Strict human-in-the-loop enforcement to prevent AI-paraphrased PR intent.
  • Seamless integration with gh pr edit --body-file for programmatic PR updates.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*