# Crafting Commits

> Automatically invoked when user requests git commit message creation, commit drafting, or needs help with conventional commit formatting. Handles conventional commit standards.

- Skill: `majiayu000/crafting-commits-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/crafting-commits-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/crafting-commits-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/majiayu000/crafting-commits-2

---


# Crafting Git Commits

A professional git commit message drafting service that follows modern conventional commit standards, provides collaborative attribution, and includes quality validation for reliable development workflows.

This skill follows the principle of progressive disclosure. This file contains the core workflow and high-level guidance. For more detailed information, please refer to the linked reference files.

## Freedom Levels & Model Guidance

- **Level 1 (Autonomous)**: Simple commits like `fix`, `docs`, `style`, and `chore`. I can execute these autonomously.
- **Level 2 (Validation Required)**: Complex changes such as `feat`, `refactor`, and `perf`. I will ask for your confirmation before proceeding.
- **Level 3 (Explicit Approval)**: Critical modifications or breaking changes. I will require your explicit approval before committing.

## Core Workflow

1.  **Analysis**: I start by analyzing the staged changes to understand the context.
    -   `git status`
    -   `git diff --staged`
    -   `git log --oneline -5`
2.  **Planning**: I identify the commit type, scope, and assess any potential impact, including breaking changes.
3.  **Validation**: I use a detailed checklist to ensure the commit message meets all quality standards. See [validation.md](validation.md) for the full checklist.
4.  **Execution**: I draft the commit message, add attribution, and execute the commit, verifying it in the git history.

## Reference Documents

For detailed information, please refer to these files:

- **[examples.md](examples.md)**: A comprehensive list of commit message examples for different scenarios (features, bug fixes, docs, etc.).
- **[validation.md](validation.md)**: Detailed checklists for validating commits at all freedom levels.
- **[patterns.md](patterns.md)**: Advanced patterns, formatting best practices, and attribution guidelines.
- **[troubleshooting.md](troubleshooting.md)**: A guide to common Git errors and recovery procedures.

## Utility Scripts

This skill includes executable scripts for validation and analysis.

-   **`scripts/validate_commit.sh`**: Checks if a commit message follows the conventional commit format.
-   **`scripts/check_attribution.sh`**: Validates the `Co-Authored-By` format in a commit message.
-   **`scripts/analyze_changes.sh`**: Provides a summary of staged changes to help draft a commit message.

## System Requirements

-   Git version 2.25.0 or higher
-   Bash shell access
-   Standard Unix tools (`ls`, `grep`, etc.)