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?

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."

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

Agents — Autonomous Reviewers

Specialized agents that act as senior technical leads:

Targeting an Odoo version

The Odoo agents automatically pick the right reference pack (skills/odoo-17.0/, odoo-18.0/, or odoo-19.0/). Resolution order:

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

Per-version rule deltas (e.g. <tree> vs <list>, group_operator= vs aggregator=, optional _name in v19) live in each pack's references/api-highlights.md.

Rules — Coding Standards

Enforced patterns for consistent, secure code:

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

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