git-commit

Create conventional git commits with Linear ticket references.

5|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/f4irline/bbqparty-ai --skill git-commit-f4irline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-commit
Source: https://github.com/f4irline/bbqparty-ai/tree/main/packages/opencode/.opencode/skills/git-commit
Command: npx skills add https://github.com/f4irline/bbqparty-ai --skill git-commit-f4irline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent or poorly formatted commit messages and missing ticket references make it hard to track changes, attribute work, and automate release notes; this Skill produces clear, discoverable commits that follow a conventional format and link to Linear tickets.

Core Features & Use Cases

  • Produces commit subjects and bodies that follow the Conventional Commits specification with an appended Refs: {ticket-id} line for traceability.
  • Handles staging guidance, validates staged diffs, recommends running tests and linters before committing, and optionally uses an authenticated bot identity for author and committer metadata.
  • Use cases include creating feature, fix, refactor, docs, test, chore, perf, style, and ci commits that consistently reference Linear tickets for automated workflows and release generation.

Quick Start

Generate a conventional commit for ticket STU-15 describing a bug fix to the api, ensure changes are staged and tests pass, and commit with a message including Refs: STU-15.

Frequently Asked Questions about git-commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create conventional commits with Linear ticket references automatically?

To create conventional commits with Linear ticket references, you need a structured format that appends 'Refs: {ticket-id}' to the commit body. This ensures traceability for features, fixes, and refactors while enabling automated release notes and workflow tracking.

What is the best way to format git commit messages for automated release notes?

The best way to format git commit messages for automated release notes is using the Conventional Commits specification. This format uses standardized types and optional scopes, making changes discoverable and easily linked to project management tickets.

Can I use a bot identity for git author and committer metadata when staging changes?

Yes, you can use an authenticated bot identity for git author and committer metadata. This is configured during the commit process after validating staged diffs, ensuring automated commits are properly attributed to the bot rather than a personal account.

How do I validate staged changes and run tests before creating a conventional commit?

Validating staged changes and running tests before creating a conventional commit involves checking the staged diff and recommending linters and test suites. This ensures code quality before generating the commit message with the required ticket reference.

Does conventional commit formatting work for backend, mobile, and infrastructure code repositories?

Yes, conventional commit formatting works for backend, mobile, and infrastructure code repositories. It handles feature, fix, docs, test, chore, and ci commits, ensuring consistent messages and traceability across different project scopes.

Why do my git commits need a Refs line for Linear ticket tracking?

Git commits need a 'Refs: {ticket-id}' line for Linear ticket tracking to ensure traceability. Appending this reference links the codebase changes directly to the ticket, making it easy to attribute work and automate workflow updates.