Agent skill

Odoo Commit

by unclecatvn in unclecatvn/agent-skills

Guides Odoo-style commit creation following official Odoo git guidelines.

MITAuto-check passedDevelopment

Install Odoo Commit

skills CLI
$ npx skills add unclecatvn/agent-skills --skill odoo-commit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install unclecatvn/agent-skills odoo-commit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/unclecatvn/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/odoo-commit .claude/skills/odoo-commit && rm -rf skills-src

Use ~/.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/

Facts

Skill name
odoo-commit
GitHub stars
143
Token cost
~1.7k tokens
SKILL.md length
742 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Guides Odoo-style commit creation following official Odoo git guidelines.

  • Works in 6 steps: Run git diff --stat and git status… → If the change is a direct continuation… → Stage relevant files by name - never git… → …
  • Tasks that involve Commit messages
  • SKILL.md covers Workflow, Format, Subject Line Rules and Tags, plus 4 more sections
  • Calls git

What it does

Odoo Commit is an agent skill from unclecatvn/agent-skills. Guides Odoo-style commit creation following official Odoo git guidelines. Drafts [TAG] module: short description messages, checks whether to amend or create a new commit, stages files explicitly, commits via git commit -F, and keeps local history clean before PRs. Auto-invokes for commit-related requests in Odoo repositories and takes priority over generic commit skills.

Its SKILL.md is about 1.7k 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 and Git workflow. It works with Odoo, Git and Python. The repository describes itself as: Odoo Skills Documentation. The licence is MIT.

When your agent uses it

  • Tasks that involve Commit messages
  • Tasks that involve Git workflow

Example prompts

  • “Use the odoo-commit skill to guide Odoo-style commit creation following official Odoo git guidelines”
  • “/odoo-commit”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Run git diff --stat and git status --short to see what changed, plus
  2. If the change is a direct continuation or fix of that unpushed HEAD commit,
  3. Stage relevant files by name - never git add -A or git add ..
  4. Write the commit message to a temporary file, then commit with git commit -F
  5. Before opening a pull request, squash your own back-and-forth commits into one
  6. Report the resulting commit hash and subject.

What it can do on your machine

Read from SKILL.md and the folder at commit 3039ef3. 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

    Links to these hosts (documentation or services it may open):

    • github.com
    • odoo.com

    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

Odoo Commit loads about 1.7k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 742 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

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 unclecatvn/agent-skills at commit 3039ef3, republished under its MIT licence (© unclecatvn). 742 words, ~1,729 tokens.

Download SKILL.mdSave it as .claude/skills/odoo-commit/SKILL.md (or your agent's skills folder).
name
odoo-commit
description
Guides Odoo-style commit creation following official Odoo git guidelines. Drafts `[TAG] module: short description` messages, checks whether to amend or create a new commit, stages files explicitly, commits via `git commit -F`, and keeps local history clean before PRs. Auto-invokes for commit-related requests in Odoo repositories and takes priority over generic commit skills.

Workflow

  1. Run git diff --stat and git status --short to see what changed, plus git log -1 --oneline (and git log @{u}.. --oneline if a remote-tracking branch exists) to see the last local commit and whether it's still unpushed.

  2. If the change is a direct continuation or fix of that unpushed HEAD commit, skip drafting a new message and fold it in instead of creating a second commit for the same logical change:

    bash
    git add <file>
    git commit --amend --no-edit   # or drop --no-edit to also revise the message

    Otherwise, draft a new commit message.

  3. Stage relevant files by name - never git add -A or git add ..

  4. Write the commit message to a temporary file, then commit with git commit -F:

bash
cat > /tmp/odoo-commit-message.txt <<'EOF'
[TAG] module: short description

Optional body line.
EOF
git commit -F /tmp/odoo-commit-message.txt

Any equivalent temp-file flow is fine (for example, using PowerShell's Set-Content or another editor) as long as the final commit is created with git commit -F <file>.

  1. Before opening a pull request, squash your own back-and-forth commits into one clean commit per logical change (per OCA guidelines): the rest of the world doesn't need your intermediate "fix bug 1", "fix bug 2" history - only the final state and a clear summary. For a single trailing fix, git commit --amend (step 2) is usually enough; for folding several commits into one, use an interactive rebase instead:

    bash
    git rebase -i HEAD~N   # N = number of commits to fold

    Keep the first line as pick with the real [TAG] module: description message, mark the rest fixup (drop their messages) or squash (merge messages):

    pick 1949129 [IMP] module: Introduce feature A
    fixup d2cf643 Fix bug 1 of feature A
    fixup 42bd9e8 Fix bug 2 of feature A
    fixup 7f767d5 Fix bug 3 of feature A

    Either way, only rewrite commits that are still local/unpushed, or on a branch you alone own - never amend or rebase shared history without confirming with the user first.

  2. Report the resulting commit hash and subject.

Do not bypass pre-commit hooks. If a hook fails, fix the issue, re-stage the changes, and create the commit again.

Format

[TAG] module: short description

Optional body explaining WHY, not what. What is visible in the diff.
Focus on motivation, constraints, and decisions made.

task-XXXX, opw-XXXXXX

Subject Line Rules

  • [TAG] module: description - tag in brackets, then module name, colon, space, description
  • Target the whole header ([TAG] module: description) at about 50 characters for readability; 72 is a hard ceiling, not something to aim for
  • Self-test: the header must read as a valid sentence after "if applied, this commit will <header>" - e.g. [IMP] base: prevent to archive users linked to active partners -> "if applied, this commit will prevent to archive users linked to active partners"
  • Never use single, vague words like "bugfix" or "improvements" as the description - it must be self-explanatory and state the reason for the change
  • Imperative mood: "add", "fix", "remove" - not "added", "fixes"
  • No trailing period
  • Module = technical module name (e.g. hhc, plc, nhso_stddataset, imc)
  • Avoid touching multiple modules in one commit - split per module so each can be reverted independently. If truly unavoidable, list the modules or use various
Show full SKILL.md (310 more words)Show less

Tags

  • [FIX] - bug fix; used in stable versions, also valid for recent dev bugs
  • [REF] - refactoring: feature heavily rewritten
  • [ADD] - adding new modules
  • [REM] - removing resources: dead code, views, modules
  • [REV] - reverting commits
  • [MOV] - moving files (no content change; use git mv)
  • [REL] - release commits: major/minor stable versions
  • [IMP] - improvements: most incremental dev changes
  • [MERGE] - merge commits / forward port of bug fixes
  • [CLA] - signing Odoo Individual Contributor License
  • [I18N] - translation file changes
  • [PERF] - performance patches
  • [CLN] - code cleanup
  • [LINT] - linting passes

Body Rules

  • Skip body when subject is self-explanatory
  • Include body for: non-obvious WHY, breaking changes, migration notes, task references
  • Explain WHY, not WHAT - the diff already shows what changed. WHAT is only worth spelling out when a technical choice or trade-off was involved, and then explain WHY that choice was made
  • Don't force brevity for its own sake: official Odoo guidance explicitly says not to hesitate being verbose when the reasoning deserves it. Every line should still earn its place - no restating the diff, no filler
  • Wrap at 72 characters per line
  • Reference task IDs at the end: task-XXXX, opw-XXXXXX, Fixes #123, Closes #123

What Never Goes In

  • "This commit does X" - the diff says what
  • "I", "we", "now", "currently"
  • AI attribution of any kind: Co-Authored-By: Claude ... trailers, Generated with Claude Code lines, session links. If the tooling injects one, remove it before committing
  • Restating the file name or module when the subject already says it

Pull Requests

  • Title = the commit header ([TAG] module: description); one logical change per PR
  • Body explains WHY and how it was verified (test command, screenshots for views); the diff shows WHAT
  • No AI attribution anywhere in the body: no "Generated with" footer, no Co-Authored-By, no session links
  • Do not add or edit author/reviewer lines; git already records the author

Examples

Examples from the official Odoo git guidelines:

[REF] models: use `parent_path` to implement parent_store

This replaces the former modified preorder tree traversal (MPTT) with the
fields `parent_left`/`parent_right`[...]
[FIX] account: remove frenglish

[...]

Closes #22793
Fixes #22769
[FIX] website: remove unused alert div, fixes look of input-group-btn

Bootstrap's CSS depends on the input-group-btn element being the first/last
child of its parent. This was not the case because of the invisible and
useless alert.

Header-only, illustrating the "valid sentence" self-test:

[IMP] base: prevent to archive users linked to active partners

© unclecatvn, MIT. 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 skills/odoo-commit of unclecatvn/agent-skills.

Open the folder on GitHubat commit 3039ef3

Compare with similar skills

Odoo Commit 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.

Odoo Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Odoo Commit this skillunclecatvn/agent-skills143—~1.7kAutomated safety check: PassMIT
Saleor Commit Workflowsaleor/saleor23k—~575Automated safety check: PassBSD-3-Clause
Adk Gitgoogle/adk-python22k—~1.3kAutomated safety check: PassApache-2.0
Git Batch Commitcat-xierluo/legal-skills713—~1.7kAutomated safety check: NotesMIT
Openclaw PlusLeoYeAI/openclaw-master-skills2.2k—~5.3kAutomated safety check: PassMIT
ToolJet Multi-Repo CommitToolJet/ToolJet41k—~1.3kAutomated safety check: PassAGPL-3.0

Similar skills

  • Commits changes in the Saleor codebase and works through pre-commit hook failures from ruff, mypy, the GraphQL schema check and the migrations check.

    23k GitHub stars~575 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Adk Git

    google/adk-python

    Official

    Writes commit messages and pull request descriptions for the adk-python repository: Conventional Commits types and scopes, subject lines that say why a change was made, and the linked-issue and…

    22k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Git Batch Commit

    cat-xierluo/legal-skills

    智能 Git 批量提交快捷按钮。触发词:"git 提交"、"批量提交"、"拆分提交"、"整理提交",或用户明确要把已暂存变更拆成多个聚焦 commit 时使用。只负责 commit 拆分和提交信息生成;分支、PR、push、merge、Issue 关闭语义以 git-workflow 为准。提交完成后,若仓库内存在 skill-publish-sync 或 subtree-publish…

    713 GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Openclaw Plus

    LeoYeAI/openclaw-master-skills

    A modular super-skill combining developer and web capabilities.

    2.2k GitHub stars~5.3k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • 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.

    41k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • 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.

    102k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes

More from unclecatvn/agent-skills

All 8 skills in this repo
  • Odoo Workflow

    unclecatvn/agent-skills

    Mandatory pre-code gate and definition-of-done for ANY Odoo change (add field, override method, inherit view/xpath, OWL/JS patch, wizard, cron, controller, report, security, migration, bug fix…

    143 GitHub stars~4.7k tokensUpdated 13 days ago
    Auto-check passed
  • Code Review

    unclecatvn/agent-skills

    A skill your agent uses when receiving code review feedback (especially if unclear or technically questionable), when completing tasks or major features requiring review before proceeding, or before…

    143 GitHub stars~1.3k tokensUpdated 13 days ago
    Auto-check passed
  • Odoo 16

    unclecatvn/agent-skills

    Odoo 16 development reference for Python models and ORM (search, domain, readgroup, compute fields), XML/CSV data and views, OWL/JS client code, QWeb reports, security (ACL, record rules, groups)…

    143 GitHub stars~1.4k tokensUpdated 13 days ago
    Auto-check passed
  • Odoo 17

    unclecatvn/agent-skills

    Odoo 17 development reference for Python models and ORM (search, domain, readgroup, compute fields), XML/CSV data and views, OWL/JS client code, QWeb reports, security (ACL, record rules, groups)…

    143 GitHub stars~1.4k tokensUpdated 13 days ago
    Auto-check passed
  • Odoo 18

    unclecatvn/agent-skills

    Odoo 18 development reference for Python models and ORM (search, domain, readgroup, compute fields), XML/CSV data and views, OWL/JS client code, QWeb reports, security (ACL, record rules, groups)…

    143 GitHub stars~1.3k tokensUpdated 13 days ago
    Auto-check passed
  • AI Vibe Slides

    unclecatvn/agent-skills

    Create beautiful, professional HTML or React slide decks ready for fullscreen presentation.

    143 GitHub stars~3.5k tokensUpdated 13 days ago
    Auto-check passed

Works with

Categories

Questions about Odoo Commit

What does Odoo Commit do?

Guides Odoo-style commit creation following official Odoo git guidelines. Odoo Commit is an agent skill from unclecatvn/agent-skills. Guides Odoo-style commit creation following official Odoo git guidelines.

When should I use Odoo Commit?

Odoo Commit fits situations like: tasks that involve Commit messages; tasks that involve Git workflow.

How do I install Odoo Commit in Claude Code?

Run `npx skills add unclecatvn/agent-skills --skill odoo-commit -a claude-code`. Or copy the skill folder (skills/odoo-commit in unclecatvn/agent-skills) into .claude/skills/odoo-commit in your project. Claude Code loads it when a task matches its description.

How do I install Odoo Commit in Codex?

Run `npx skills add unclecatvn/agent-skills --skill odoo-commit -a codex`. Or copy the skill folder (skills/odoo-commit in unclecatvn/agent-skills) into .agents/skills/odoo-commit in your project. Codex loads it when a task matches its description.

Can I use Odoo Commit 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 unclecatvn/agent-skills --skill odoo-commit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/odoo-commit, .gemini/skills/odoo-commit, .github/skills/odoo-commit and .opencode/skills/odoo-commit in your project.

What does Odoo Commit need to run?

Going by SKILL.md and its folder, Odoo Commit needs the command-line tools its instructions call (git).

Does Odoo Commit access the network?

SKILL.md names 2 domains. As links in the text: github.com and odoo.com. This is read from the text; nothing was executed.

Is Odoo Commit 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 Odoo Commit use?

Odoo Commit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Odoo Commit use?

About 1.7k tokens (SKILL.md is roughly 6.9k 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 Odoo Commit?

Skills that share tags, products or a category with Odoo Commit: Saleor Commit Workflow (saleor/saleor, 23k stars), Adk Git (google/adk-python, 22k stars), Git Batch Commit (cat-xierluo/legal-skills, 713 stars) and Openclaw Plus (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Odoo Commit?

unclecatvn (a GitHub user) maintains it in unclecatvn/agent-skills, which has 143 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 24, 2026.

Source: unclecatvn/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.