kata-contributing-pr

Create standards-compliant GitHub Pull Requests with Conventional Commit titles and labels.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-contributing-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-contributing-pr
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-contributing-pr
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-contributing-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you reliably create a Pull Request for code changes by enforcing branch, commit, labeling, and template requirements so your contribution is accepted smoothly.

Core Features & Use Cases

  • Analyze changes against repository rules: checks repo status, enumerates commits, and verifies they follow the Lexis conventions before you proceed.
  • Prepare a standards-compliant branch: ensures your branch name matches the required {type}/{issue-number}-{slug} format and that the related issue is complete.
  • Create the PR with correct metadata: composes the PR title and body from the proper template, creates the PR via GitHub MCP (or falls back to gh), then mirrors issue labels and applies PR-specific labels when needed.

Quick Start

Ask the AI to help you create a PR for your current changes by verifying your commits follow the Lexis, preparing a valid {type}/{issue-number}-{slug} branch, pushing it to the remote, generating the PR body from the repository template, and creating the PR targeting main with the correct labels.

Frequently Asked Questions about kata-contributing-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub pull request with conventional commit titles and correct labels?

Creating a GitHub pull request with conventional commit titles requires analyzing your feature branch changes, validating commit history against repository rules, and applying mirrored issue labels. The workflow then generates a compliant PR using the correct template and metadata conventions.

What's the best way to enforce branch naming rules before opening a pull request?

Enforcing branch naming rules before opening a pull request involves validating your branch against the required `{type}/{issue-number}-{slug}` format. The process ensures your related issue is complete and your branch name matches contribution workflow standards before pushing to remote.

How do I automate mirroring issue labels when creating a pull request?

Automating issue label mirroring when creating a pull request happens after PR creation via GitHub MCP or gh CLI fallback. The workflow reads labels from the associated issue, applies them to the new PR, and stamps any additional PR-specific labels or cost directives required by the repository.

Does GitHub MCP work with conventional commit PR workflows, or do I need gh CLI?

GitHub MCP is the preferred method for conventional commit PR workflows, with gh CLI available as a fallback. Both methods support creating standards-compliant pull requests by composing the PR title and body from the proper repository template and applying correct label conventions.

Why does my pull request fail repository contribution workflow checks?

Pull requests fail repository contribution workflow checks when branch names do not match the `{type}/{issue-number}-{slug}` format, commit history violates conventions, or the PR body lacks the correct template. Final verification steps validate metadata, labels, and assignees before completion.

Can I validate commit history against repository rules before creating a PR?

Validating commit history against repository rules before creating a PR is a core preparatory step. The process enumerates your commits, verifies they follow the required Lexis conventions, and checks repository status to ensure your contribution will be accepted smoothly.