Agent Skills

Curated AI skill packs for Odoo, payments, and MCP — 55k+ lines of framework expertise for your AI coding assistant.

---

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
• 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 specific frameworks and technologies. This means better code suggestions, fewer mistakes, and more helpful responses.

---

Why use it?

Without Agent Skills	With Agent Skills
Generic "how to write a Python function"	Framework-specific "how to write an Odoo 18 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 17 / 18 / 19)
Generic security suggestions	Enforced security rules for enterprise applications

---

Quick Start

Get started in 30 seconds with NPX:

# Add Agent Skills to your current project
npx skills add unclecatvn/agent-skills

That's it! Your AI assistant will now have access to all the skills in this repository.

---

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 18 conventions: # 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 specifically for AI consumption:

Skill	Description
Odoo 17.0	Odoo 17 development (tree views, direct-expression attrs, group_operator=, _sql_constraints, JSONB translations, OWL 2.8)
Odoo 18.0	Odoo 18 development (ORM, views, security, OWL, reports, migrations, performance)
Odoo 19.0	Odoo 19 development guide with current conventions
DTG Base	DTGBase utilities (date/period, timezone, batch, barcode, Vietnamese text)
Payment Integration	SePay, Polar, Stripe, Paddle, Creem.io and related patterns
Code Review	Standards and workflows for automated code review
Brainstorming	Structured framework for feature ideation and spec review
Writing Skills	Creating and editing AI skills (structure, evals, quality)
MCP Builder	Building Model Context Protocol servers
Slide (AI Vibe Slides)	Self-contained HTML/React slide decks for fullscreen presentation

Agents — Autonomous Reviewers

Specialized agents that act as senior technical leads:

Agent	What it does
Odoo Code Review	Reviews Odoo code with scoring (1–10) and structured feedback
Odoo Code Tracer	Traces execution flow from an entry point through the call graph
Planner	Breaks down complex features into actionable implementation steps

Rules — Coding Standards

Enforced patterns for consistent, secure code:

Rule	Description
Coding Style	Best practices for naming, imports, and code structure
Security	Security patterns for enterprise applications

---

Project Structure

agent-skills/
├── skills/
│   ├── odoo-17.0/             # Odoo 17 guides
│   ├── odoo-18.0/             # Odoo 18 guides
│   ├── odoo-19.0/             # Odoo 19 guides
│   ├── dtg-base/              # DTGBase utilities
│   ├── payment-integration/   # Payment integrations
│   ├── code-review/           # Code review standards
│   ├── brainstorming/         # Ideation and spec review
│   ├── writing-skills/        # Authoring AI skills
│   ├── mcp-builder/           # MCP servers
│   └── slide/                 # HTML/React slide decks
├── agents/                    # Odoo reviewers + planner
├── rules/                     # Coding style and security
├── bin/                       # CLI entry point
└── lib/                       # Shared assets (e.g. images)

---

Supported IDEs

Agent Skills works with popular AI-powered IDEs via npx skills add:

• Cursor — Rules, remote rules
• Claude Code — Native skill support
• Windsurf — Compatible
• Aider — Compatible

---

How It Works

flowchart LR
    A[👤 Developer] -->|writes prompt| B[🤖 AI Assistant]
    B -->|reads| C[📚 Agent Skills]
    C --> D[Framework Knowledge]
    C --> E[Best Practices]
    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. You add Agent Skills to your project
2. Your AI assistant reads the relevant skill files
3. The AI uses this context to provide framework-specific guidance
4. You get better, more accurate code assistance

---

Stats

Metric	Value
Documentation	55,000+ lines
Skill packs	10 (Odoo 17.0, 18.0, 19.0, DTG Base, Payment, Code Review, Brainstorming, Writing Skills, MCP Builder, Slide)
Agents	3 (Odoo Code Review, Odoo Code Tracer, Planner)
License	MIT

---

Contributing

We welcome contributions! Here's how you can help:

• Add new skills — Create documentation for other frameworks
• Improve existing docs — Fix errors, add examples
• Create agents — Build specialized reviewers or planners
• Report issues — Let us know what's missing or broken

Open an issue or discussion on GitHub if you want to propose changes or new skills.

---

Links

• Issues
• Discussions
• Releases
• npm Package

---

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