agentsclimarketplace

Conventional commit gen

Skill serejaris/kimi-skills/skills/conventional-commit-gen

Полная коллекция скиллов Kimi (267 built-in + 7 plugin skills), выгруженная из сандбокса агента

Install
npx -y skills add serejaris/kimi-skills --skill conventional-commit-gen

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 20 days oldThe repository was created 20 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Analyzes git diff to generate commit messages following the Conventional Commits spec, with automatic scope detection and commit type inference. Trigger when users ask to write or generate a commit message, mention Conventional Commits, git commits, standardized commits, scope detection, or phrases like 'help me write a commit message'.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

4.1 KB, 813 tokens by cl100k_base, as published. Nobody here has run it

Conventional Commit Gen

Analyzes the current git diff and automatically generates a commit message that follows the Conventional Commits specification, with smart scope detection.

Quick Start

# Analyze unstaged changes and generate a commit message
python3 scripts/analyze_diff.py

# Analyze staged changes only
python3 scripts/analyze_diff.py --staged

# Specify a repository path
python3 scripts/analyze_diff.py --repo /path/to/repo

# JSON output (useful for programmatic integration)
python3 scripts/analyze_diff.py --staged --format json

# Manually override type or scope
python3 scripts/analyze_diff.py --staged --type-override feat --scope-override auth

Usage Workflow (SOP)

1. Get the Diff Analysis

Run the script in the user's git repository to get the automated analysis:

python3 scripts/analyze_diff.py --staged --format json

2. Review and Adjust

The script outputs:

  • type: The auto-detected commit type (feat / fix / docs / style / refactor / test / chore / perf / ci / build)
  • scope: The scope detected from file paths (e.g., auth, api, ui)
  • description: A brief description generated from the change summary
  • commit_message: The fully assembled commit message

After reviewing the output, adjust as needed:

  • If the type is inaccurate (e.g., the script detected chore but it's actually a feat), use --type-override to override
  • If the scope doesn't fit, use --scope-override to override
  • The description should ideally be hand-written based on the actual changes; treat the script output as a starting point

Note: Type detection is based on file paths and change statistics. It works well for types like test/docs/ci/build, but for modifications to existing source code files (feat vs fix vs refactor), you should read the diff content and make the final call.

3. Conventional Commits Reference

<type>(<scope>): <description>

[optional body]

[optional footer(s)]
TypeMeaning
featA new feature
fixA bug fix
docsDocumentation changes
styleCode formatting (no logic changes)
refactorRefactoring (no new features or bug fixes)
testTest-related changes
choreBuild/tooling/dependency maintenance
perfPerformance improvements
ciCI/CD configuration changes
buildBuild system or external dependency changes

4. Breaking Changes

If the change includes a breaking change, add ! after the type:

feat(api)!: change authentication endpoint response format

Parameters

ParameterDescriptionDefault
--repoPath to the git repository.
--stagedAnalyze staged changes onlyNo
--formatOutput format: text or jsontext
--type-overrideManually specify the commit type, skipping auto-detectionNone
--scope-overrideManually specify the scope, skipping auto-detectionNone

Prerequisites

  • Python 3.6+
  • git installed and available in PATH
  • Current directory or --repo points to a valid git repository

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.