Skip to content
BranchesTags

Repository files navigation

Agent Skills

Agent Skills Hero

Curated AI skill packs for Odoo development, code review, and professional workflows — 57k+ lines of version-pinned framework expertise.

npm version npm downloads License: MIT GitHub stars GitHub last commit PRs Welcome Node.js

Table of Contents

What is Agent Skills?

Agent Skills is a collection of documentation and specialized agents that supercharge AI coding assistants like Cursor, Claude Code, Windsurf, and Aider.

Think of it as a knowledge pack — when you add Agent Skills to your project, your AI assistant gains access to thousands of lines of curated technical expertise about Odoo and related workflows. That means better code suggestions, fewer version-mismatch bugs, and more helpful responses.

Each Odoo skill pack is pinned to a specific major version (16.0 · 17.0 · 18.0 · 19.0) with an api-highlights.md file that captures the rules that differ between versions.

Why use it?

Without Agent Skills With Agent Skills
Generic "how to write a Python function" Framework-specific "how to write an Odoo model with proper ORM patterns"
AI guesses at framework conventions AI follows documented best practices
You re-explain project context every session Context lives in the repo — AI reads it automatically
Subtle bugs from outdated or mixed-version advice Version-pinned guides (Odoo 16 / 17 / 18 / 19)
Generic security suggestions Enforced security rules for enterprise applications

Quick Start

Option 1 — Cursor Skills (recommended)

Install the full repository into your project:

npx skills add unclecatvn/agent-skills

Your AI assistant will discover skills, agents, and rules from the repo automatically.

Option 2 — CLI (pick a skill pack and version)

Install a specific pack into your project with the bundled CLI:

# List available Odoo versions
npx @unclecat/agent-skills-cli versions skills

# Install Odoo 18 guides for Cursor
npx @unclecat/agent-skills-cli init --ai cursor --skill skills --version odoo-18.0

# Install for all supported assistants
npx @unclecat/agent-skills-cli init --ai all --skill skills --version odoo-19.0

Supported --ai targets: cursor, claude, antigravity, kiro, docs, all.

Other installable packs: code-review, dtg-base, flow-diagram, odoo-commit, slide.

Option 3 — Claude Code plugin

Install via the Claude plugin marketplace defined in .claude-plugin/marketplace.json. The plugin bundles Odoo skill packs (16–19), code review, DTG Base, Odoo Commit, Flow Diagram, slide decks, and the Odoo review/tracer agents.

Real-World Example

Prompt:

"Add a computed field total_with_tax to sale.order that sums line totals plus VAT."

Without Agent Skills With Agent Skills 
# Generic guess — may use
# wrong API for your Odoo version
total_with_tax = fields.Float(
    compute='_compute_total'
)

def _compute_total(self):
    for rec in self:
        rec.total_with_tax = sum(
            l.price * 1.1
            for l in rec.order_line
        )
 
# Odoo conventions (16 / 17 / 18 / 19):
# Monetary + @api.depends + store
total_with_tax = fields.Monetary(
    compute='_compute_total_with_tax',
    store=True,
    currency_field='currency_id',
)

@api.depends('order_line.price_total')
def _compute_total_with_tax(self):
    for order in self:
        order.total_with_tax = sum(
            order.order_line.mapped('price_total')
        )

What's Inside?

Skills — Framework Documentation

In-depth guides written for AI consumption. Each Odoo pack includes 18 topic guides plus api-highlights.md, SKILL.md, CLAUDE.md, and AGENTS.md.

Skill Description
Odoo 16.0 Odoo 16 development — <tree> views, attrs/states modifiers, group_operator=, explicit chatter block, kanban-box templates
Odoo 17.0 Odoo 17 development — <tree> views, direct-expression modifiers (no attrs), group_operator=, JSONB translations, OWL 2.8
Odoo 18.0 Odoo 18 development — <list> views, aggregator=, <chatter/> shortcut, ORM, security, OWL, reports, migrations, performance
Odoo 19.0 Odoo 19 development — optional _name, models.Constraint / models.Index, current view and frontend conventions
Odoo Commit Guides Odoo-style commit creation — message drafting, amend-vs-new-commit decisions, explicit staging, git commit -F, and local history cleanup before PRs
Flow Diagram Interactive self-contained HTML+SVG flow/architecture diagrams — zoom/pan, click-to-highlight flows, traveling dots, collision checkers
DTG Base DTGBase utilities — date/period, timezone, batch processing, barcode, Vietnamese text, file helpers
Code Review Receiving feedback, requesting reviews, and verification gates for evidence-based development
Slide (AI Vibe Slides) Self-contained HTML/React slide decks for fullscreen presentation

Odoo reference guide topics (each version)

actions · controllers · data files · decorators · development workflow · fields · manifest · migrations · mixins · models · OWL · performance · reports · security · testing · transactions · translations · views

Agents — Autonomous Reviewers

Specialized agents that act as senior technical leads:

Agent What it does
Odoo Code Review Reviews Odoo code with scoring and structured feedback. Version-aware (16 / 17 / 18 / 19).
Odoo Code Tracer Traces execution flow from an entry point through the call graph. Version-aware (16 / 17 / 18 / 19).
Planner Breaks down complex features into actionable implementation steps

Rules — Coding Standards

Enforced patterns for consistent, secure code:

Rule Description
Coding Style Naming, imports, and code structure
Security Security patterns for enterprise applications

Targeting an Odoo Version

The Odoo agents automatically pick the right reference pack (skills/odoo-16.0/ … odoo-19.0/). Resolution order:

  1. Explicit argument passed to the agent (e.g. odoo_version: "19.0").
  2. Project config, in order:
    • .odoo-version at the repo root
    • odoo_version in .claude/odoo.json
    • odoo.version in package.json
    • tool.odoo.version in pyproject.toml
  3. Manifest heuristic — dominant major version from workspace __manifest__.py files.
  4. Fallback — latest supported (19.0). The agent states the assumption in its output.

Per-version rule deltas live in each pack's references/api-highlights.md. Examples:

Topic 16.0 17.0 18.0+
List view tag <tree> <tree> <list>
Dynamic modifiers attrs / states direct expressions direct expressions
Field aggregation group_operator= group_operator= aggregator=
Chatter explicit block explicit block <chatter/>

Project Structure

agent-skills/
├── skills/
│   ├── odoo-16.0/             # Odoo 16 guides + api-highlights
│   ├── odoo-17.0/             # Odoo 17 guides + api-highlights
│   ├── odoo-18.0/             # Odoo 18 guides + api-highlights
│   ├── odoo-19.0/             # Odoo 19 guides + api-highlights
│   ├── odoo-commit/           # Odoo-style commit workflow and message guidance
│   ├── flow-diagram/          # Interactive HTML+SVG flow/architecture diagrams
│   ├── dtg-base/              # DTGBase utilities
│   ├── code-review/           # Code review workflow
│   └── slide/                 # HTML/React slide decks
├── agents/
│   ├── odoo-code-review/      # Version-aware Odoo reviewer
│   ├── odoo-code-tracer/      # Version-aware call-graph tracer
│   └── planner.md             # Feature planning agent
├── rules/                     # Coding style and security
├── bin/                       # CLI (`agent-skills`)
├── tests/                     # Structural validator (`npm test`)
├── .claude-plugin/            # Claude Code plugin + marketplace
├── .github/workflows/         # CI, SkillSpector scan, release guards
├── CHANGELOG.md
└── lib/                       # Shared assets (images)

Supported IDEs

Agent Skills works with popular AI-powered IDEs:

IDE / Tool Install method
Cursor npx skills add unclecatvn/agent-skills or CLI --ai cursor
Claude Code Plugin marketplace or CLI --ai claude
Antigravity CLI --ai antigravity
Kiro CLI --ai kiro
Plain docs folder CLI --ai docs

How It Works

flowchart LR
    A[Developer] -->|writes prompt| B[AI Assistant]
    B -->|reads| C[Agent Skills]
    C --> D[Version-pinned Odoo guides]
    C --> E[Review agents]
    C --> F[Security rules]
    D --> G[Better code]
    E --> G
    F --> G
    G -->|returns| A

    style C fill:#4f46e5,stroke:#312e81,color:#fff
    style G fill:#10b981,stroke:#064e3b,color:#fff
Loading
  1. Add Agent Skills to your project (Cursor, CLI, or Claude plugin).
  2. Your AI assistant reads the relevant skill files for the task.
  3. Odoo agents resolve the target version and load the matching reference pack.
  4. You get framework-specific guidance instead of generic guesses.

Stats

Metric Value
Documentation ~57,000 lines
Odoo skill packs 4 (16.0, 17.0, 18.0, 19.0)
Other skill packs 5 (DTG Base, Code Review, Odoo Commit, Flow Diagram, Slide)
Agents 3 (Odoo Code Review, Odoo Code Tracer, Planner)
Rules 2 (Coding Style, Security)
Current release 1.0.13
License MIT

Contributing

Contributions are welcome:

  • Improve Odoo guides — fix errors, add examples, keep version deltas accurate
  • Add new skill packs — follow the structure in skills/odoo-18.0/
  • Extend agents — build specialized reviewers or planners under agents/
  • Report issues — open an issue if something is missing or broken

Before opening a PR:

npm test          # structural validation (SKILL.md frontmatter, plugin paths, changelog)

CI also runs SkillSpector on ./skills/ with a baseline in .skillspector-baseline.yaml. Version bumps require a matching section in CHANGELOG.md.

Contributors Open Issues Open PRs

Links

If you find this project helpful, please consider giving it a star.

Star History Chart

About

Odoo Skills Documentation

Topics

odooodoo-18odoo-19odoo-addonsodoo-projectpythonpython3skillskill-odoo

Resources

Readme
MIT license
Activity

Stars

119 stars

Watchers

8 watching

Forks

56 forks
Report repository

Releases

Packages

Contributors

Languages