Agent Skills

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

---

Table of Contents

• What is Agent Skills?
• Why use it?
• Quick Start
• Real-World Example
• What's Inside?
  • Skills — Framework Documentation
  • Agents — Autonomous Reviewers
  • Rules — Coding Standards
• Targeting an Odoo Version
• Project Structure
• Supported IDEs
• How It Works
• Stats
• Contributing
• Links

---

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

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.

---

Links

• Changelog
• Issues
• Discussions
• Releases
• npm Package

---

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