git-conventions

Enforce Conventional Commits syntax, subject length, imperative mood, and anti-secrets rules.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/karstenheld3/SharePoint-GPT-Middleware --skill git-conventions-karstenheld3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-conventions
Source: https://github.com/karstenheld3/SharePoint-GPT-Middleware/tree/main/.windsurf/skills/git-conventions
Command: npx skills add https://github.com/karstenheld3/SharePoint-GPT-Middleware --skill git-conventions-karstenheld3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill standardizes git history by enforcing conventional commit messages, improving traceability and release notes.

Core Features & Use Cases

  • Enforce Conventional Commits syntax: types (feat, fix, docs, refactor, test, chore, style, perf) and optional scopes.
  • Validate commit subjects under 72 characters and use imperative mood, with no trailing period.
  • Prevent leaking secrets by filtering sensitive files and providing guidance for pre-commit checks and CI integration.

Quick Start

Configure your repository to use Conventional Commits by enabling a pre-commit hook or CI checks, then consistently apply commit types such as feat(auth): add login flow or fix(api): correct timeout handling.

Frequently Asked Questions about git-conventions

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

FAQPage Schema
How do I enforce conventional commits in my git repository?

Conventional commits enforce a standardized message format using type prefixes like feat, fix, docs, and refactor. Enable pre-commit hooks or CI checks to validate commits match the syntax and follow rules like imperative mood, subject line under 72 characters, and no trailing periods.

What is the conventional commits format and why use it?

Conventional commits standardize git history with structured messages (type: scope: description) to improve traceability, automate release notes, and enable teams to quickly understand what changed and why. It applies across feature branches, PRs, and release workflows.

Can I prevent secrets from being committed to git?

Yes. This skill filters sensitive files and provides guidance for integrating pre-commit checks and CI validation to catch and block secret leaks before commits reach the repository.

How do I set up commit message validation for my team?

Configure a pre-commit hook or add CI checks to enforce conventional commit syntax, validate subject length under 72 characters, require imperative mood, and filter sensitive data. Apply consistently across all developers and branches.

Does conventional commits work with pull requests and release workflows?

Yes. Conventional commits apply across feature branches, pull requests, and release workflows, enabling consistent history tracking and automated generation of release notes based on commit types and scopes.

What commit types are included in the conventional commits standard?

The standard includes feat, fix, docs, refactor, test, chore, style, and perf types with optional scopes. Each type signals the nature of the change, supporting automated release note generation and history classification.