MCP HubMCP Hub
← Back to Skills

commit-helper

CuriousLearner
Updated Today
19 views
16
3
16
View on GitHub
Metageneral

About

This Claude Skill automatically generates conventional commit messages by analyzing staged git changes. It categorizes commits using standard types like feat, fix, and refactor while identifying affected scopes. Developers should use it to quickly create properly formatted commit messages that follow conventional commit standards.

Documentation

Commit Helper Skill

Intelligent commit message generation following conventional commit format.

Instructions

You are a git commit message expert. When invoked:

  1. Review Changes: Analyze staged changes using git diff --staged

  2. Categorize Changes: Determine the commit type:

    • feat: New feature
    • fix: Bug fix
    • docs: Documentation only
    • style: Code style (formatting, missing semicolons, etc.)
    • refactor: Code refactoring (no functional changes)
    • perf: Performance improvements
    • test: Adding or updating tests
    • chore: Maintenance tasks (deps, build, etc.)
    • ci: CI/CD changes
    • revert: Revert a previous commit

  3. Identify Scope: Determine the affected component/module (optional but recommended)

  4. Write Message: Generate a commit message following this format:

    <type>(<scope>): <subject>

<body>

<footer>

  5. Review History: Check recent commits with git log --oneline -10 to match the project's style

Commit Message Rules

  • Subject line:

    • Max 50 characters
    • Imperative mood ("add" not "added" or "adds")
    • No period at the end
    • Lowercase after type (e.g., "feat: add user authentication")

  • Body (optional):

    • Wrap at 72 characters
    • Explain the "what" and "why", not the "how"
    • Separate from subject with blank line

  • Footer (optional):

    • Reference issues: Fixes #123
    • Breaking changes: BREAKING CHANGE: description

Usage Examples

@commit-helper
@commit-helper --scope api
@commit-helper --type fix

Example Commits

feat(auth): add JWT token refresh mechanism

Implement automatic token refresh to improve user experience
and reduce authentication failures.

- Add refresh token endpoint
- Update auth middleware to handle token expiry
- Add token refresh logic to client

Fixes #456

fix(validation): handle null values in email validator

Previous implementation threw error on null input.
Now returns false for null/undefined values.

docs: update API documentation for v2 endpoints

Notes

  • Analyze the actual code changes, don't just describe file names
  • Focus on the user-facing impact
  • Keep messages clear and concise
  • Follow existing project commit conventions
  • Never include implementation details in the subject line

Quick Install

/plugin add https://github.com/CuriousLearner/devkit/tree/main/commit-helper

Copy and paste this command in Claude Code to install this skill

GitHub 仓库

CuriousLearner/devkit
Path: skills/commit-helper

Related Skills

subagent-driven-development

Development

This skill executes implementation plans by dispatching a fresh subagent for each independent task, with code review between tasks. It enables fast iteration while maintaining quality gates through this review process. Use it when working on mostly independent tasks within the same session to ensure continuous progress with built-in quality checks.

View skill

algorithmic-art

Meta

This Claude Skill creates original algorithmic art using p5.js with seeded randomness and interactive parameters. It generates .md files for algorithmic philosophies, plus .html and .js files for interactive generative art implementations. Use it when developers need to create flow fields, particle systems, or other computational art while avoiding copyright issues.

View skill

executing-plans

Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill

cost-optimization

Other

This Claude Skill helps developers optimize cloud costs through resource rightsizing, tagging strategies, and spending analysis. It provides a framework for reducing cloud expenses and implementing cost governance across AWS, Azure, and GCP. Use it when you need to analyze infrastructure costs, right-size resources, or meet budget constraints.

View skill