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.
Install
/plugin marketplace add milistu/agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add milistu/agent-skills --skill conventional-commentsgit 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-commentsPersonal 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. |
Details
- Skill name
conventional-comments- Repository
- milistu/agent-skills
- 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
9milistu/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.
Challenge Me
9milistu/agent-skills
Direct technical advisor mode for counting/estimation and architecture/design
Conventional Commits
9milistu/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.
Oss Finder
9kargnas/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).
PR Message
9milistu/agent-skills
Write a concise, high-signal GitHub pull request message that explains intent, impact, and risk
Git Lore
9kargnas/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.
Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.