Index of every page on this site: llms.txt
All skills
bitwarden avatar

/labeling-changes

@a11c77b official
by bitwardenbitwarden/ai-plugins165 stars
27
Run it yourself

Conventional commit type keywords for PR titles and commit messages. Use when determining the change type for commits or PRs, or when another delivery skill asks for the type keyword and its t: label. Triggered by "what type", "label", "change type", "conventional commit", "t: label".

Use this Skill: https://skilld.dev/gh/bitwarden/ai-plugins/labeling-changes

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈76 tokens for metadata: the name and description. ≈627 when used: this file.

Description uses 3.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈304 characters, or 3.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Labeling Changes

PR titles and commit messages must include a conventional commit type keyword. This keyword drives automatic t: label assignment via CI (.github/scripts/label-pr.py reads .github/label-pr.json).

Return the chosen type keyword and the t: label it maps to.

Format

The type keyword appears after the Jira ticket prefix:

[PM-XXXXX] <type>: <imperative summary>

The CI labeling script matches <type>: or <type>( in the lowercased PR title, so the keyword must be followed by a colon or parenthesis.

Type Keywords

Type Label Use for
feat t:feature New features or functionality
fix t:bug Bug fixes
refactor t:tech-debt Code restructuring without behavior change
chore t:tech-debt Maintenance, cleanup, minor tweaks
test t:tech-debt Adding or updating tests
perf t:tech-debt Performance improvements
docs t:docs Documentation changes
ci / build t:ci CI/CD and build system changes
deps t:deps Dependency updates
llm t:llm LLM/Claude configuration changes
breaking t:breaking-change Breaking changes requiring migration
misc t:misc Changes that do not fit other categories

CI also accepts additional aliases (e.g., revert, bugfix, cleanup). See .github/label-pr.json for the full mapping.

Selecting a Type

Infer the type from the task description and changes made. If the type cannot be confidently determined, ask the user.

Ambiguous Cases

  • Refactor that incidentally fixes a bug → use the primary intent: fix: if the bug was the goal, refactor: if the restructuring was the goal
  • Adding tests for existing untested code → test: (not chore:)
  • Updating a dependency to fix a vulnerability → deps: (not fix:)
  • Changing Claude/LLM configuration files → llm: (not chore:)
  • Removing dead code → refactor: (not chore: — it changes the codebase structure)

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill provides instructions and a mapping table for conventional commit types and GitHub labels. It is an informational resource for formatting pull request titles and contains no security risks.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at a11c77b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago
  • conventional-commits
  • ci
  • labeling
  • github-actions
  • jira
  • pr-automation

README badge

README badge for bitwarden/ai-plugins/labeling-changes

Enforces conventional commit type keywords in PR titles and commit messages, enabling automated label assignment via CI. Install this skill when titling commits or PRs in Bitwarden's workflow — it provides the type keyword reference and selection guidance for ambiguous cases.

Generated from the current SKILL.md.

What conventional commit types does this skill support?
The skill references a table in `change-type-labels.md` with type keywords and CI label mappings. Consult that file for the full list and guidance on selecting a type for ambiguous cases.
How does the CI labeling script match the type keyword?
The script matches `<type>:` or `<type>(` in the lowercased PR title, so the keyword must be followed by a colon or parenthesis.
What should I do if the change type is ambiguous?
Ask the user to clarify the change type rather than guessing. The skill is designed to prompt for user input when the type cannot be confidently determined.
Where does the type keyword go in the commit message?
The type keyword appears after the Jira ticket prefix: `[PM-XXXXX] <type>: <imperative summary>`.

Generated from the current SKILL.md. These answers refresh after source changes.