Contextual Commit Messages
yamadashy/repomix
Writes Conventional Commits whose bodies carry action lines recording the intent, decisions and constraints behind a change, not only what changed.
AReaL commit message conventions. An agent skill from areal-project/AReaL.
Install Commit Conventions
$ npx skills add areal-project/AReaL --skill commit-conventions -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install areal-project/AReaL commit-conventions --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/areal-project/AReaL.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/commit-conventions .claude/skills/commit-conventions && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "commit-conventions" agent skill from https://github.com/areal-project/AReaL/tree/main/.agents/skills/commit-conventions into .claude/skills/commit-conventions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commit-conventions", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/areal-project/AReaL/tree/main/.agents/skills/commit-conventionsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add areal-project/AReaL --skill commit-conventions -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install areal-project/AReaL commit-conventions --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/areal-project/AReaL.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/commit-conventions .agents/skills/commit-conventions && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "commit-conventions" agent skill from https://github.com/areal-project/AReaL/tree/main/.agents/skills/commit-conventions into .agents/skills/commit-conventions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commit-conventions", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add areal-project/AReaL --skill commit-conventions -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install areal-project/AReaL commit-conventions --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/areal-project/AReaL.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/commit-conventions .cursor/skills/commit-conventions && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "commit-conventions" agent skill from https://github.com/areal-project/AReaL/tree/main/.agents/skills/commit-conventions into .cursor/skills/commit-conventions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commit-conventions", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/areal-project/AReaL.git --path .agents/skills/commit-conventions--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add areal-project/AReaL --skill commit-conventions -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install areal-project/AReaL commit-conventions --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/areal-project/AReaL.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/commit-conventions .gemini/skills/commit-conventions && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "commit-conventions" agent skill from https://github.com/areal-project/AReaL/tree/main/.agents/skills/commit-conventions into .gemini/skills/commit-conventions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commit-conventions", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install areal-project/AReaL commit-conventionsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add areal-project/AReaL --skill commit-conventions -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/areal-project/AReaL.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/commit-conventions .github/skills/commit-conventions && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "commit-conventions" agent skill from https://github.com/areal-project/AReaL/tree/main/.agents/skills/commit-conventions into .github/skills/commit-conventions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commit-conventions", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add areal-project/AReaL --skill commit-conventions -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install areal-project/AReaL commit-conventions --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/areal-project/AReaL.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/commit-conventions .opencode/skills/commit-conventions && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "commit-conventions" agent skill from https://github.com/areal-project/AReaL/tree/main/.agents/skills/commit-conventions into .opencode/skills/commit-conventions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commit-conventions", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
commit-conventions- GitHub stars
- 5.8k
- Token cost
- ~1.6k tokens
- SKILL.md length
- 216 words
- Files
- 1
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
AReaL commit message conventions. An agent skill from areal-project/AReaL.
- Works in 2 steps: Add the file path pattern and scope to… → Keep table sorted by areal/ subpackages…
- Tasks that involve Commit messages
- SKILL.md covers When to Use, Commit Message Format, Type Selection and Scope Inference, plus 4 more sections
- Calls git
What it does
Commit Conventions is an agent skill from areal-project/AReaL. AReaL commit message conventions. MUST load on every git commit -- provides Conventional Commits format with scope inference from file paths.
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Commit messages. The repository describes itself as: The RL Bridge for LLM-based Agent Applications. Made Simple & Flexible. The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Commit messages
Example prompts
- “/commit-conventions”
Workflow steps
2 steps, taken from the first numbered list in SKILL.md.
- Add the file path pattern and scope to the "Scope Inference" table
- Keep table sorted by areal/ subpackages first, then top-level dirs
What it can do on your machine
Read from SKILL.md and the folder at commit a642540. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Commit Conventions loads about 1.6k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 216 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from areal-project/AReaL at commit a642540, republished under its Apache-2.0 licence (© areal-project). 216 words, ~1,581 tokens.
Download SKILL.mdSave it as
.claude/skills/commit-conventions/SKILL.md (or your agent's skills folder).- name
- commit-conventions
- description
- AReaL commit message conventions. MUST load on every git commit -- provides Conventional Commits format with scope inference from file paths.
Commit Conventions
Commit message conventions and scope inference rules for the AReaL repository.
When to Use
ALWAYS load this skill when making any git commit in AReaL. This includes:
- Direct commits (
git commit) - Commits during PR creation (
$create-pr//create-pr) - Commits delegated to sub-agents with this skill loaded
- Any agent workflow that produces a commit
Commit Message Format
<type>(<scope>): <subject>
<body>
[Optional sections:]
Key changes:
- change 1
- change 2
Refs: #123, #456Type Selection
| Type | When to Use |
|---|---|
feat | New feature or capability |
fix | Bug fix |
docs | Documentation only |
gov | Governance or maintainer changes |
style | Formatting/style-only changes |
refactor | Code change without feature/fix |
perf | Performance improvement |
test | Adding or fixing tests |
build | Build system or dependencies |
ci | CI pipeline or workflow changes |
chore | Build, deps, config changes |
revert | Revert a previous commit |
Scope Inference
Infer scope from the primary changed file paths:
| File Path Pattern | Scope |
|---|---|
areal/workflow/ | workflow |
areal/engine/ | engine |
areal/reward/ | reward |
areal/dataset/ | dataset |
areal/api/ | api |
areal/utils/ | utils |
areal/infra/ | infra |
areal/trainer/ | trainer |
areal/models/ | models |
areal/experimental/ | experimental |
docs/ | docs |
examples/ | examples |
AGENTS.md, .agents/, .claude/, .codex/, .opencode/ | agents |
| Multiple areas | Omit scope or use broader term |
Rules
- Subject: imperative mood, ~50-72 chars, no trailing period
- Body: explain "why" not "what", wrap at 72 chars
- Key changes: bullet list of main modifications (for complex commits with 3+ files)
- Refs: reference issues/PRs if applicable
Show full SKILL.md (177 more words)Show less
Examples
Single file fix:
fix(reward): handle empty completion in gsm8k
Return 0 reward instead of raising exception when
completion string is empty after extraction.Multi-file feature:
feat(engine): add CPU offload support to ArchonEngine
Enable torch_memory_saver for model offloading during
rollout phase to reduce GPU memory pressure.
Key changes:
- Add offload/onload methods to ArchonEngine
- Integrate with weight update flow
- Handle ROCm compatibilityDocs only:
docs: update algorithm comparison table
Add SAPO and GSPO to the algorithm family documentation
with configuration examples.Agent/tooling changes:
chore(agents): port review-pr command to OpenCode
Add OpenCode-native commands with task() category
delegation instead of hardcoded model names.
Key changes:
- Create .opencode/command/ with review-pr, create-pr
- Replace hardcoded model routing with platform-native review routing
- Add expert subagent consultation patternsGovernance/maintainer changes:
gov(agents): add maintainer ownership for service modules
Update CODEOWNERS and maintainer references to reflect
current governance responsibilities.
Key changes:
- Add maintainers for agent_service and infra ownership
- Align governance docs with updated reviewer responsibilities<!--
================================================================================
MAINTAINER GUIDE
================================================================================
Canonical location: .agents/skills/commit-conventions/SKILL.md
Mirrors: .opencode/skills/commit-conventions/SKILL.md, .claude/skills/commit-conventions/SKILL.md
Invocation: Automatically loaded on every git commit (all platforms)
## Purpose
Provides Conventional Commits format with AReaL-specific scope inference
from file paths. Unlike other skills, this one is NOT user-triggered --
it is loaded by the system/agent on every commit operation.
## How to Update
### When New Modules Are Added
1. Add the file path pattern and scope to the "Scope Inference" table
2. Keep table sorted by areal/ subpackages first, then top-level dirs
### When Commit Types Change
1. Update the "Type Selection" table
2. Add/update examples to illustrate the new type
### When Adding Examples
1. Each example should demonstrate a distinct commit pattern
2. Keep examples realistic -- use actual AReaL module names
3. Show both subject-only and subject+body+key-changes variants
### Important Design Decisions
- This skill is ALWAYS loaded (not optional) -- keep it concise to
minimize token overhead on every commit
- Scope inference is path-based, not content-based -- simpler and
more deterministic
- "Multiple areas" -> omit scope rather than invent a new one
================================================================================
-->© areal-project, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/commit-conventions of areal-project/AReaL.
Open the folder on GitHubat commit a642540
Compare with similar skills
Commit Conventions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Commit Conventions this skillareal-project/AReaL | 5.8k | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| Contextual Commit Messagesyamadashy/repomix | 29k | 1 repos | ~2.7k | Automated safety check: Pass | MIT | |
| React Router Release Notes Prepremix-run/react-router | 57k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Caveman Commitvishiri/fantasia-archive | 409 | 13 repos | ~642 | Automated safety check: Pass | GPL-3.0 | |
| PR Finalize Reviewmicrosoft/garnet | 12k | — | ~3.1k | Automated safety check: Pass | MIT | |
| ToolJet Multi-Repo CommitToolJet/ToolJet | 41k | — | ~1.3k | Automated safety check: Pass | AGPL-3.0 |
Similar skills
React Router Release Notes Prep
remix-run/react-router
Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.
Caveman Commit
vishiri/fantasia-archive
Ultra-compressed commit message generator. An agent skill from vishiri/fantasia-archive.
- Official
PR Finalize Review
microsoft/garnet
Checks that a pull request's title and description match its implementation and reviews the code for Garnet best practices, reporting findings without posting them.
ToolJet Multi-Repo Commit
ToolJet/ToolJet
Commits changes across ToolJet's root repo and its server/ee and frontend/ee submodules, writing messages from the diffs and updating submodule pointers in order.
Git Workflow and Versioning
addyosmani/agent-skills
Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.
More from areal-project/AReaL
All 11 skills in this repoAdd Dataset
areal-project/AReaL
Guide for adding a new dataset loader to AReaL. An agent skill from areal-project/AReaL.
Add Reward
areal-project/AReaL
Guide for adding a new reward function to AReaL. An agent skill from areal-project/AReaL.
Debug Distributed
areal-project/AReaL
Guide for debugging distributed training issues in AReaL. An agent skill from areal-project/AReaL.
Add Archon Model
areal-project/AReaL
Guide for adding a new model to the Archon engine. An agent skill from areal-project/AReaL.
Add Unit Tests
areal-project/AReaL
Guide for adding unit tests to AReaL. An agent skill from areal-project/AReaL.
Add Workflow
areal-project/AReaL
Guide for adding a new RolloutWorkflow to AReaL. An agent skill from areal-project/AReaL.
Related
Categories
Questions about Commit Conventions
What does Commit Conventions do?
AReaL commit message conventions. An agent skill from areal-project/AReaL. Commit Conventions is an agent skill from areal-project/AReaL. AReaL commit message conventions.
When should I use Commit Conventions?
Commit Conventions fits situations like: tasks that involve Commit messages.
How do I install Commit Conventions in Claude Code?
Run `npx skills add areal-project/AReaL --skill commit-conventions -a claude-code`. Or copy the skill folder (.agents/skills/commit-conventions in areal-project/AReaL) into .claude/skills/commit-conventions in your project. Claude Code loads it when a task matches its description.
How do I install Commit Conventions in Codex?
Run `npx skills add areal-project/AReaL --skill commit-conventions -a codex`. Or copy the skill folder (.agents/skills/commit-conventions in areal-project/AReaL) into .agents/skills/commit-conventions in your project. Codex loads it when a task matches its description.
Can I use Commit Conventions in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add areal-project/AReaL --skill commit-conventions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/commit-conventions, .gemini/skills/commit-conventions, .github/skills/commit-conventions and .opencode/skills/commit-conventions in your project.
What does Commit Conventions need to run?
Going by SKILL.md and its folder, Commit Conventions needs the command-line tools its instructions call (git).
Does Commit Conventions access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Commit Conventions safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Commit Conventions use?
Commit Conventions is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Commit Conventions use?
About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Commit Conventions?
Skills that share tags, products or a category with Commit Conventions: Contextual Commit Messages (yamadashy/repomix, 29k stars), React Router Release Notes Prep (remix-run/react-router, 57k stars), Caveman Commit (vishiri/fantasia-archive, 409 stars) and PR Finalize Review (microsoft/garnet, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Commit Conventions?
areal-project (a GitHub organization) maintains it in areal-project/AReaL, which has 5,817 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.
Source: areal-project/AReaL on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.