kata-commit

Generate and validate Conventional Commits messages against Guardia Lexis rules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you consistently create standardized commit messages that comply with Guardia Lexis, including correct formatting, atomic change scope, language requirements, and GPG signing (when using the local path).

Core Features & Use Cases

  • Conventional message composition: Guides you to choose a valid commit type and optional scope, then write an English imperative subject within 72 characters, optionally adding an English/local-language tagged body and standard footers.
  • Lexis validation before committing: Enforces conventional format, small/atomic commits, language-tag rules, and signed-commit requirements.
  • Authorship routing (human vs warriors-default-author): Uses directives to decide whether to create a remotely signed commit via a GitHub App token or to sign locally with GPG, including required fallbacks.

Real-world example: you finish a small, single-purpose refactor in your repository, want a Conventional Commits message (like fix/auth) with a clear rationale, and need the commit to be properly signed and validated against Guardia Lexis before you publish.

Quick Start

Use the kata-commit workflow to analyze your staged changes, generate a Conventional Commits message, validate it against the four Lexis rules, and then execute either the remote GitHub App commit or a local GPG-signed commit with final verification.

Frequently Asked Questions about kata-commit

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

FAQPage Schema
How do I create conventional commits that pass Guardia Lexis compliance checks?

Atomic commits isolate a single logical change into one commit so the history remains clean and reversible. This Skill enforces atomic commit rules by validating your staged changes, ensuring each commit serves a single purpose and passes Conventional Commits formatting checks before execution.

How do I sign Git commits with GPG when pushing via a GitHub App?

Guardia Lexis requires Conventional Commits formatting, small atomic commits, language-tagged message bodies, and cryptographically signed authorship. This Skill acts as a preflight validator, checking your staged changes against all four rules to ensure compliance before the commit is finalized.

What is the best way to automate commit message formatting for Conventional Commits?

This Skill applies to staged-change workflows in Git where you must produce Conventional Commits-compliant messages and verified authorship. It supports both local GPG signing and remote GitHub App commit paths, making it suitable for environments enforcing strict Lexis compliance.

Why does my commit fail Lexis validation when using a conventional commit message?

Your commit may fail Lexis validation if the message lacks proper language tags, exceeds the 72-character subject limit, or contains non-atomic changes. This Skill prevents such failures by running preflight validation on staged changes to enforce all four Lexis rules before committing.