Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

commit-style

/commit-style

Podaje konwencje pisania komunikatów commitów i opisów pull requestów: temat, wzorce prefiksów, treść i dobór czasowników.

Repozytorium
config ↗
Licencja
MIT
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Podaje konwencje pisania komunikatów commitów i opisów pull requestów: temat, wzorce prefiksów, treść i dobór czasowników.

Wyzwalacze z opisu

commitgit commitwrite commit messagepull requestPR description
Oryginalny opis (EN)

This skill should be used when writing git commit messages, creating git commits, composing pull request titles and descriptions, or when the user asks to "commit", "git commit", "write commit message", "pull request", or "PR description". Provides conventions for subject lines, prefix patterns, body content, and verb choices.

Jak działa

  1. Subject Line
  2. Prefix Pattern
  3. Body
  4. Pull Request Titles and Descriptions
  5. Git Command Usage
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 737 słów
Podgląd SKILL.md
---
name: commit-style
description: This skill should be used when writing git commit messages, creating git commits, composing pull request titles and descriptions, or when the user asks to "commit", "git commit", "write commit message", "pull request", or "PR description". Provides conventions for subject lines, prefix patterns, body content, and verb choices.
version: 0.3.0
---

# Git Commit Style

Conventions for writing git commit messages and pull request descriptions. Project-specific conventions always take priority.

## Subject Line

- Try to keep under 50 characters total
- No trailing period
- Lowercase imperative verbs: `fix`, `add`, `remove`, `use`, `avoid`, `ensure`, `adjust`, `allow`, `enable`, `extract`, `introduce`, `show`, `move`, `roll`
- Capital letter only when starting with a proper noun or class name — never capitalize verbs
- Embed the "why" directly when possible: `avoid enlarging small images`, `avoid double-save on withdraw`
- Technical identifiers kept verbatim: `config.x.asset_file_uploadable`, `event_submission_open?`
- Arrow notation for renames: `ops-lb: rknw -> rknet`

### Keeping Under 50 Characters

Techniques when the subject runs long:

- Drop `add` when the subject already names the primary new thing: `site-sessions: SiteSession model` not `… add SiteSession model` — keep `add` when supplementing existing code (specs, logging)
- Omit secondary artifacts when the primary deliverable is clear: `site-sessions: SiteSessionIssuance service` not `… service and background jobs` — mention omitted parts in the body
- `&` over `and`: `PrimarySession & User changes`
- Drop qualifiers the prefix already provides: `site-sessions: PrimarySession & User changes` not `… for site sessions`

### Contextful Verbs

Prefer specific verbs over generic ones:

- `avoid` or `address` over `fix` for preventive changes
- `extract` over `refactor` when pulling out a concern/class
- `introduce` over `add` when creating a new concept/abstraction
- `reflect` over `update` when syncing with external state
- `gains` for new capabilities (component as subject): `SponsorEvent: gains hero image upload`
- `learns` for new options/parameters: `TitoApi: learns v3.1 pagination`
- `no longer` for behavioral removals: `event_submission_open? no longer gates asset uploads`
- `roll` for dependency updates and referenced image/git tag updates, `releng` for release engineering, `trigger` for CI/build triggers
  - `roll` is short for "roll out": the object is what gets rolled, followed directly by the version, never `to`: `roll sorah/glazed 0.3.0`, `roll himari-lambda image 5b9d6b9`, not `roll image to 0.3.0`

## Prefix Pattern

Format: `prefix: rest of subject` — use when the commit targets a specific component.

Prefix types vary by what is being changed:
- **Class/module name** (PascalCase, matching actual name; short, greppable, consistent — prefer over lowercase descriptive forms): `SponsorEventAssetFilesController: fix set_asset_file authorization`, `SiteSessionRenewal: just propagate errors`
- **Method reference** (Class#method): `SponsorEventsController#destroy: avoid double-save on withdraw`
- **View/route path**: `broadcasts/show: sort recipients alphabetically`
- **Feature/epic name** (hyphenated, no spaces — consistent across a series): `event-assets: begin validation`, `site-sessions: SiteSession model`
- **File or directory**: `Dockerfile: build minimal libvips`, `CI: install libvips-tools`
- **Subsystem/infra name**: `tf/k8s: ...`, `radius: ...`, `grafana: ...`

Omit prefix when:
- The subject already names the target: `Extract GithubInstallation from GenerateSponsorsYamlFileJob`
- Whole-project or obvious-context changes: `roll latest dependencies`, `trigger build for 3.2.10`
- Terse commits: `typo`, `wip`, `oops`

## Body

The most important role of the body is to explain background and context that is **NOT obvious from the diff**. The diff shows what changed; the body explains why it was changed, what problem it solves, or what non-obvious behavior motivated the change.

- Do not repeat what the diff already says — focus on what a reader cannot infer from code alone
- Opening sentence or paragraph: the background, rationale, or problem
- Bullet list with `- ` when enumerating multiple specifics
- Wrap lines at ~72 characters
- Issue references: `Closes #N`
- Skip body entirely when the subject + diff are self-explanatory

Examples:

```
sponsor_events: wrap asset file update in transaction

Prevent data loss when replacing a hero image and the subsequent
update fails validation. The old asset file destroy is now rolled
back if the event update doesn't succeed.
```

```
SponsorEventsController#destroy: avoid double-save on withdraw

withdrawn! saves immediately, creating one editing history record,
then save! creates a second one with no meaningful diff. The job
was enqueued with the second history, missing the status change
and skipping YAML regeneration.
```

## Pull Request Titles and Descriptions

Apply the same subject line conventions to PR titles (under 70 chars).

- **Single-commit branch**: use the commit subject as title and commit body as description
- **Multi-commit branch**: write a concise summary title, then explain individual commits under headings or bullet points using Markdown

Never include test procedures, test plans, QA checklists, task lists, or TODO checkboxes in PR descriptions.

## Git Command Usage

- Never use `git -C <path>` — it invalidates pre-approved permissions in Claude Code. Always `cd` to the target directory first, then run git commands.

Wersje

W bazie nie ma innych skilli o nazwie commit-style.

Migawka bazy z 13.11.2026 · wersja paczki 73317e642695 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100commit
    Opisuje konwencje komunikatów commitów i opisów pull requestów oraz prowadzi przez czysty przepływ commitowania.
  • 95git-commits
    Pisze jasne komunikaty commitów i tytuły pull requestów według Conventional Commits, poprawiając historię zmian.
  • 100git-practices
    Opisuje konwencje Git dla gałęzi, komunikatów commitów i pull requestów.
  • 100plei-git
    Pisze i przegląda komunikaty commitów zgodne z Conventional Commits oraz opisy pull requestów.
  • 100commit-message
    Generuje komunikaty commitów w formacie conventional commits i pomaga przy tworzeniu commitów git.
  • 90Conventional Commits
    Podaje wzorce Conventional Commits, czyli spójne i czytelne maszynowo komunikaty commitów.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.