Conventional Comments

Format review comments following the Conventional Comments standard. Use when writing code review comments, PR feedback, RFC reviews, peer reviews, or when the user asks for help with review comments.

9 starsGit & Code Review Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add milistu/agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add milistu/agent-skills --skill conventional-comments
Manual install
git clone --depth 1 https://github.com/milistu/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/conventional-comments ~/.claude/skills/conventional-comments

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Conventional Comments

Based on the [Conventional Comments](https://conventionalcomments.org/) standard. Comments that are easy to grok and grep.

## Comment Format

```
<label> [decorations]: <subject>

[discussion]
```

- **label** (required) — a single word signifying the kind of comment
- **subject** (required) — the main message of the comment
- **decorations** (optional) — extra classifiers in parentheses, comma-separated, placed after the label
- **discussion** (optional) — supporting statements, context, reasoning, and next steps

## Labels

Use these labels to prefix every comment:

| Label | Purpose |
|-------|---------|
| `praise` | Highlight something positive. Leave at least one per review. Must be sincere — false praise is damaging. |
| `nitpick` | Trivial, preference-based request. Non-blocking by nature. |
| `suggestion` | Propose an improvement. Be explicit about *what* and *why*. |
| `issue` | Highlight a specific problem (user-facing or internal). Pair with a suggestion when possible. |
| `todo` | Small, trivial, but necessary change. Simpler than an issue or suggestion. |
| `question` | Potential concern you're not sure about. Ask for clarification or investigation. |
| `thought` | An idea that emerged from reviewing. Non-blocking, but valuable for mentoring and focused initiatives. |
| `chore` | Task that must be done before acceptance. Link to the process description when possible. |
Read the full skill on GitHub

Details

Skill name
conventional-comments
Path
skills/conventional-comments/SKILL.md
Repo updated
27 July 2026

FAQ

What does the Conventional Comments skill do?

Format review comments following the Conventional Comments standard. Use when writing code review comments, PR feedback, RFC reviews, peer reviews, or when the user asks for help with review comments.

How do I install the Conventional Comments skill?

Claude Code plugin: /plugin marketplace add milistu/agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Conventional Comments popular?

It lives in milistu/agent-skills, which has 9 GitHub stars and 0 forks.

Related skills

Apple Human Interface Guidelines

9

milistu/agent-skills

Apple Human Interface Guidelines (HIG) reference for designing iOS, iPadOS, macOS, tvOS, visionOS, watchOS apps. Covers UI components, layout, accessibility, typography, navigation, inputs, and platform technologies. Use when designing Apple platform UIs, reviewing SwiftUI/UIKit patterns, or applying HIG design principles to any app.

Frontend & Design

Challenge Me

9

milistu/agent-skills

Direct technical advisor mode for counting/estimation and architecture/design

Software Development

Conventional Commits

9

milistu/agent-skills

Generate commit messages following the Conventional Commits v1.0.0 specification with Angular convention types. Use when creating git commits, writing commit messages, or when the user asks for help with commit messages.

Git & Code Review

Oss Finder

9

kargnas/skills

Finds battle-tested open-source repos, libraries, frameworks, CLI tools, or code on GitHub, ranked by README polish-days instead of stars. Also the shared GitHub code-search backend toolkit — rotating PAT pool, grep.app, Blackbird web index, BigQuery/GHArchive, and the code-search fallback chain. Use for 'find a library/framework/tool for X', 'battle-tested repo', GitHub-wide code search, or when `gh search code` rate-limits. Finding installable SKILL.md agent-skill packages goes to the skill-finder skill (it delegates its GitHub sweep here).

Git & Code Review

PR Message

9

milistu/agent-skills

Write a concise, high-signal GitHub pull request message that explains intent, impact, and risk

Git & Code Review

Git Lore

9

kargnas/skills

Captures, queries, and configures decision context in native Git trailers. Use for non-trivial commit messages, constraints, rejected alternatives, directives, test gaps, Lore history queries, or installing Lore rules in project or global agent instructions.

Git & Code Review

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.