generating-smart-commits | git-commit-smart | ClaudePluginHub

Skill

Community

generating-smart-commits

From git-commit-smart

704

Description

Use when generating conventional commit messages from staged git changes. Trigger with phrases like "create commit message", "generate smart commit", "/commit-smart", or "/gc". Automatically analyzes changes to determine commit type (feat, fix, docs), identifies breaking changes, and formats according to conventional commit standards.

Install

1

Add the repository(one-time)

$

/plugin marketplace add jeremylongshore/claude-code-plugins-plus

2

Install the plugin

$

/plugin install git-commit-smart@claude-code-plugins-plus

Tool Access

This skill is limited to using the following tools:

ReadWriteEditGrepGlobBash(git:*)

Supporting Assets

View in Repository

assets/README.md

assets/commit_template.txt

assets/example_diff.txt

references/README.md

scripts/README.md

scripts/commit_analyzer.py

scripts/commit_formatter.py

scripts/git_utils.py

Skill Content

Prerequisites

Before using this skill, ensure:

Git repository is initialized in {baseDir}
Changes are staged using git add
User has permission to create commits
Git user name and email are configured

Instructions

Analyze Staged Changes: Examine git diff output to understand modifications
Determine Commit Type: Classify changes as feat, fix, docs, style, refactor, test, or chore
Identify Scope: Extract affected module or component from file paths
Detect Breaking Changes: Look for API changes, removed features, or incompatible modifications
Format Message: Construct message following pattern: type(scope): description
Present for Review: Show generated message and ask for confirmation before committing

Output

Generates conventional commit messages in this format:

type(scope): brief description

- Detailed explanation of changes
- Why the change was necessary
- Impact on existing functionality

BREAKING CHANGE: description if applicable

Examples:

feat(auth): implement JWT authentication middleware
fix(api): resolve null pointer exception in user endpoint
docs(readme): update installation instructions

Error Handling

Common issues and solutions:

No Staged Changes

Error: "No changes staged for commit"
Solution: Stage files using git add <files> before generating commit message

Git Not Initialized

Error: "Not a git repository"
Solution: Initialize git with git init or navigate to repository root

Uncommitted Changes

Warning: "Unstaged changes detected"
Solution: Stage relevant changes or use git stash for unrelated modifications

Invalid Commit Format

Error: "Generated message doesn't follow conventional format"
Solution: Review and manually adjust type, scope, or description

Resources

Conventional Commits specification: https://www.conventionalcommits.org/
Git commit best practices documentation
Repository commit history for style consistency
Project-specific commit guidelines in {baseDir}/CONTRIBUTING.md

Links

GitHub Stats

73 forks

Similar Skills

Agent Development

This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.

47.1k

Command Development

This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.

47.1k

Hook Development

This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.

47.1k