agentsclimarketplace

Conventional commits

Skill ntk148v/skills/skills/conventional-commits

Use when creating git commits, writing commit messages, or when the user mentions conventional commits, semantic versioning, or automated changelog generation.From its SKILL.md

Install
npx -y skills add ntk148v/skills --skill conventional-commits

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

One thing to look at

  • 1 stars1 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.

SKILL.md

7.7 KB, as published. Nobody here has run it

Conventional Commits

Overview

Conventional Commits is a specification for adding human and machine-readable meaning to commit messages. It provides a standardized format that enables automated tools to generate changelogs, determine semantic version bumps, and communicate the nature of changes clearly.

When to Use

Use this skill when:

  • Creating git commits for any codebase
  • Writing commit messages that need to follow a standard format
  • The user mentions conventional commits, semantic versioning, or automated changelogs
  • Working on projects that use automated release pipelines
  • Contributing to open-source projects that require conventional commit format

Commit Message Format

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Required Elements

  1. Type: A noun indicating the category of change
  2. Description: A short summary of the change

Optional Elements

  1. Scope: Context for the change (in parentheses)
  2. Body: Detailed explanation (separated by blank line)
  3. Footer(s): Metadata like breaking changes or issue references

Commit Types

Core Types (Semantic Versioning Impact)

TypeMeaningVersion Bump
featNew featureMINOR
fixBug fixPATCH
feat! or feat with BREAKING CHANGE footerBreaking changeMAJOR

Additional Types (No Version Impact)

TypeMeaning
buildBuild system or external dependencies
choreMaintenance tasks, no production code changes
ciCI/CD configuration and scripts
docsDocumentation only changes
styleCode style (formatting, semicolons, etc.)
refactorCode refactoring without fixing bugs or adding features
perfPerformance improvements
testAdding or modifying tests
revertReverting a previous commit

Examples

Simple Commit

docs: update README with installation instructions

Commit with Scope

feat(api): add user authentication endpoint

Commit with Body

fix: prevent race condition in request handler

Introduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.

Remove timeouts which were used to mitigate the racing issue but are
obsolete now.

Breaking Change (Footer Style)

feat: allow provided config object to extend other configs

BREAKING CHANGE: `extends` key in config file is now used for extending other config files

Breaking Change (Shorthand Style)

feat!: drop support for Node 6

BREAKING CHANGE: use JavaScript features not available in Node 6.

Multiple Footers

fix: prevent racing of requests

Introduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.

Reviewed-by: Z
Refs: #123

Writing Good Descriptions

Do's

  • Use imperative mood ("add" not "added" or "adds")
  • Start with lowercase letter
  • No period at the end
  • Be concise but descriptive
  • Explain WHAT and WHY, not HOW

Don'ts

  • Don't use vague descriptions like "fix bug" or "update code"
  • Don't include issue numbers in the description (use footer instead)
  • Don't write long descriptions (use body instead)

Common Patterns

Feature Addition

feat(auth): implement OAuth2 login flow

Add support for OAuth2 authentication with Google and GitHub providers.
Includes token refresh logic and session management.

Closes #234

Bug Fix

fix(parser): handle empty input gracefully

Parser was throwing NullPointerException when receiving empty string.
Added null check and return empty result set instead.

Fixes #567

Breaking Change

refactor(api)!: rename user endpoints

BREAKING CHANGE: All /user/* endpoints renamed to /users/*
- /user/profile -> /users/profile
- /user/settings -> /users/settings

Migration guide: Update API client base paths

Documentation

docs(contributing): add PR submission guidelines

Add step-by-step guide for submitting pull requests including:
- Branch naming conventions
- Commit message format
- Required CI checks

Workflow Integration

Pre-commit Hooks

Use tools like commitlint to enforce conventional commit format:

{
  "extends": ["@commitlint/config-conventional"],
  "rules": {
    "type-enum": [
      2,
      "always",
      [
        "feat",
        "fix",
        "docs",
        "style",
        "refactor",
        "perf",
        "test",
        "build",
        "ci",
        "chore",
        "revert"
      ]
    ]
  }
}

Automated Changelog Generation

Tools like standard-version or semantic-release can automatically:

  • Generate CHANGELOG.md from commit messages
  • Bump version numbers based on commit types
  • Create git tags and GitHub releases

CI/CD Integration

# Example GitHub Actions workflow
- name: Semantic Release
  uses: cycjimmy/semantic-release-action@v3
  with:
    semantic_version: 18
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Best Practices

  1. One concern per commit: Each commit should address one issue or feature
  2. Atomic commits: Commits should be self-contained and reversible
  3. Write commits first: Draft commit messages before writing code
  4. Use scopes wisely: Scopes should be consistent across the project
  5. Reference issues: Use footers to link to issues, PRs, or tickets
  6. Test before committing: Ensure tests pass before creating commits
  7. Review your own diff: Always review changes before committing

Common Mistakes

MistakeCorrection
feat: Added new featurefeat: add new feature (imperative mood)
feat: Add new feature.feat: add new feature (no period)
feat: Add New Featurefeat: add new feature (lowercase)
feat(api,auth): ...feat(api): ... (one scope)
feat: fix bugfix: fix bug (correct type)
feat: add feature (#123)Use footer: Refs: #123

Specification Compliance

This skill follows the Conventional Commits specification v1.0.0. For the complete specification, see: https://www.conventionalcommits.org/

Key rules from the specification:

  1. Commits MUST be prefixed with a type
  2. Type MUST be followed by a colon and space
  3. Scope is OPTIONAL and enclosed in parentheses
  4. Breaking changes MUST be indicated with ! or BREAKING CHANGE footer
  5. Types other than feat and fix are allowed
  6. The specification is case-insensitive except for BREAKING CHANGE

Quick Reference

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

Breaking: Add ! after type/scope OR add BREAKING CHANGE: footer

Version Impact: feat → MINOR, fix → PATCH, BREAKING CHANGE → MAJOR

Keep looking

Skills are one crate of 608,666. 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.