finishing-a-development-branch

What This Skill Does

The finishing-a-development-branch skill serves as an automated project management assistant for OpenClaw agents. It streamlines the lifecycle of a development feature by ensuring code quality through mandatory test verification, followed by a structured workflow for integration. When an agent is tasked with finalizing a feature or bug fix, this skill orchestrates the necessary Git operations—whether that means performing a local merge, facilitating a pull request (PR) via the GitHub CLI, or safely disposing of experimental branches that are no longer needed. By enforcing a test-first completion policy, it prevents broken code from ever reaching a base branch, significantly improving team velocity and repository integrity.

Installation

To install this skill, use the following command within your terminal or OpenClaw interface:

clawhub install openclaw/skills/skills/zlc000190/finishing-a-development-branch

Use Cases

• Feature Completion: After implementing a new requirement, use this to verify all unit tests pass before merging the feature back into the main codebase.
• Automated Pull Requests: Use this to push a branch and automatically generate a structured PR template with a summary of changes and a test plan.
• Experimental Cleanup: Quickly discard local experimental branches and clean up associated git worktrees, ensuring your local environment remains uncluttered.
• CI/CD Workflow Integration: Act as an agentic gatekeeper that enforces local testing standards before any manual or automated push.

Example Prompts

1. "I think I'm finished with the authentication feature. Can you use the finishing-a-development-branch skill to wrap this up?"
2. "Everything is implemented in this branch. Please run the finishing-a-development-branch skill and prepare a pull request for me."
3. "This experiment didn't work out. Run the finishing-a-development-branch skill to discard these changes and clean up the worktree."

Tips & Limitations

• Test Pre-requisite: The skill will halt execution if tests fail. Ensure your project has a working test suite command (e.g., npm test or pytest) defined in the environment.
• Permission Requirements: Ensure your agent has necessary Git and GitHub CLI (gh) permissions configured in its environment, as this skill performs direct modifications to the repository.
• Confirmation: When choosing to discard work, the skill requires a manual confirmation word ('discard') to prevent accidental data loss.
• Worktree Awareness: The skill is specifically designed to handle Git worktrees, cleaning up temporary directory structures automatically to keep your filesystem organized.