pr-commit-workflow

What This Skill Does

The pr-commit-workflow skill serves as the central orchestration engine for managing code contributions within OpenClaw. It enforces a rigorous, high-signal process for both Git commits and GitHub Pull Requests (PRs). By acting as a structural gatekeeper, the skill ensures that every piece of code is backed by human-authored intent and verifiable evidence. It strictly adheres to pre-defined internal documentation—such as AGENTS.md or docs/agents/PROCESS.md—ensuring that the agentic behavior remains aligned with specific repository guidelines. The skill mandates the use of designated templates, manages temporary storage for draft PR bodies, and automates metadata gathering via specific shell scripts, resulting in pull requests that are clear, reviewable, and audit-friendly.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/joshp123/pr-commit-workflow Ensure your agent has the necessary permissions to access your repository files, as the skill requires reading existing project documentation to determine workflow enforcement rules.

Use Cases

This skill is ideal for professional software development teams and open-source contributors who prioritize maintainability and traceability. It is highly effective in scenarios where:

• You are managing large-scale codebases where manual PR standards are hard to maintain.
• You want to eliminate 'ghost' PRs that lack clear problem statements or context.
• You require a standardized audit trail for all changes pushed to a remote branch.
• You are training or deploying multiple agents to work on a shared repository and need consistent commit messaging.

Example Prompts

1. "I have finished the refactoring of the authentication module; please use the pr-commit-workflow skill to draft a PR based on my intent: 'Improve password hashing latency'."
2. "Review the current changes in the working directory and create a commit using the standard commit-format guidelines."
3. "Update the current open pull request #42 by appending the latest test results to the body, ensuring all evidence is included according to the PR workflow rules."

Tips & Limitations

• Tip: Always ensure your repository contains an AGENTS.md file if you have custom team rules; the skill will detect and prioritize these rules automatically.
• Tip: When providing intent, be as specific as possible. The skill prohibits agent-generated intent, so your input is the primary driver of PR quality.
• Limitation: The skill relies on external reference files (references/workflow-pr.md, etc.). If these files are missing from the environment, the skill may fail to initialize correctly. Ensure your local configuration points to the valid source repository.