{
  "markdown": "<div align=\"center\">\n\n# Agent Skills\n\n![Agent Skills Hero](lib/image/header-new.png)\n\n**Curated AI skill packs for Odoo development, code review, and professional workflows — 57k+ lines of version-pinned framework expertise.**\n\n[![npm version](https://img.shields.io/npm/v/@unclecat/agent-skills-cli.svg?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@unclecat/agent-skills-cli)\n[![npm downloads](https://img.shields.io/npm/dm/@unclecat/agent-skills-cli.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@unclecat/agent-skills-cli)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/unclecatvn/agent-skills?style=flat-square&color=yellow)](https://github.com/unclecatvn/agent-skills/stargazers)\n[![GitHub last commit](https://img.shields.io/github/last-commit/unclecatvn/agent-skills?style=flat-square)](https://github.com/unclecatvn/agent-skills/commits/main)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/unclecatvn/agent-skills/pulls)\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)\n\n</div>\n\n---\n\n## Table of Contents\n\n- [What is Agent Skills?](#what-is-agent-skills)\n- [Why use it?](#why-use-it)\n- [Quick Start](#quick-start)\n- [Real-World Example](#real-world-example)\n- [What's Inside?](#whats-inside)\n  - [Skills — Framework Documentation](#skills--framework-documentation)\n  - [Agents — Autonomous Reviewers](#agents--autonomous-reviewers)\n  - [Rules — Coding Standards](#rules--coding-standards)\n- [Targeting an Odoo Version](#targeting-an-odoo-version)\n- [Project Structure](#project-structure)\n- [Supported IDEs](#supported-ides)\n- [How It Works](#how-it-works)\n- [Stats](#stats)\n- [Contributing](#contributing)\n- [Links](#links)\n\n---\n\n## What is Agent Skills?\n\n**Agent Skills** is a collection of documentation and specialized agents that supercharge AI coding assistants like Cursor, Claude Code, Windsurf, and Aider.\n\nThink 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.\n\nEach 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.\n\n---\n\n## Why use it?\n\n| Without Agent Skills | With Agent Skills |\n|---|---|\n| Generic \"how to write a Python function\" | Framework-specific \"how to write an Odoo model with proper ORM patterns\" |\n| AI guesses at framework conventions | AI follows documented best practices |\n| You re-explain project context every session | Context lives in the repo — AI reads it automatically |\n| Subtle bugs from outdated or mixed-version advice | Version-pinned guides (Odoo 16 / 17 / 18 / 19) |\n| Generic security suggestions | Enforced security rules for enterprise applications |\n\n---\n\n## Quick Start\n\n### Option 1 — Cursor Skills (recommended)\n\nInstall the full repository into your project:\n\n```bash\nnpx skills add unclecatvn/agent-skills\n```\n\nYour AI assistant will discover skills, agents, and rules from the repo automatically.\n\n### Option 2 — CLI (pick a skill pack and version)\n\nInstall a specific pack into your project with the bundled CLI:\n\n```bash\n# List available Odoo versions\nnpx @unclecat/agent-skills-cli versions skills\n\n# Install Odoo 18 guides for Cursor\nnpx @unclecat/agent-skills-cli init --ai cursor --skill skills --version odoo-18.0\n\n# Install for all supported assistants\nnpx @unclecat/agent-skills-cli init --ai all --skill skills --version odoo-19.0\n```\n\nSupported `--ai` targets: `cursor`, `claude`, `antigravity`, `kiro`, `docs`, `all`.\n\nOther installable packs: `code-review`, `dtg-base`, `flow-diagram`, `odoo-commit`, `slide`.\n\n### Option 3 — Claude Code plugin\n\nInstall via the Claude plugin marketplace defined in [`.claude-plugin/marketplace.json`](.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.\n\n---\n\n## Real-World Example\n\n**Prompt:**\n> *\"Add a computed field `total_with_tax` to `sale.order` that sums line totals plus VAT.\"*\n\n<table>\n<tr>\n<th>Without Agent Skills</th>\n<th>With Agent Skills</th>\n</tr>\n<tr>\n<td valign=\"top\">\n\n```python\n# Generic guess — may use\n# wrong API for your Odoo version\ntotal_with_tax = fields.Float(\n    compute='_compute_total'\n)\n\ndef _compute_total(self):\n    for rec in self:\n        rec.total_with_tax = sum(\n            l.price * 1.1\n            for l in rec.order_line\n        )\n```\n\n</td>\n<td valign=\"top\">\n\n```python\n# Odoo conventions (16 / 17 / 18 / 19):\n# Monetary + @api.depends + store\ntotal_with_tax = fields.Monetary(\n    compute='_compute_total_with_tax',\n    store=True,\n    currency_field='currency_id',\n)\n\n@api.depends('order_line.price_total')\ndef _compute_total_with_tax(self):\n    for order in self:\n        order.total_with_tax = sum(\n            order.order_line.mapped('price_total')\n        )\n```\n\n</td>\n</tr>\n</table>\n\n---\n\n## What's Inside?\n\n### Skills — Framework Documentation\n\nIn-depth guides written for AI consumption. Each Odoo pack includes 18 topic guides plus `api-highlights.md`, `SKILL.md`, `CLAUDE.md`, and `AGENTS.md`.\n\n| Skill | Description |\n|-------|-------------|\n| **[Odoo 16.0](skills/odoo-16.0/)** | Odoo 16 development — `<tree>` views, `attrs`/`states` modifiers, `group_operator=`, explicit chatter block, `kanban-box` templates |\n| **[Odoo 17.0](skills/odoo-17.0/)** | Odoo 17 development — `<tree>` views, direct-expression modifiers (no `attrs`), `group_operator=`, JSONB translations, OWL 2.8 |\n| **[Odoo 18.0](skills/odoo-18.0/)** | Odoo 18 development — `<list>` views, `aggregator=`, `<chatter/>` shortcut, ORM, security, OWL, reports, migrations, performance |\n| **[Odoo 19.0](skills/odoo-19.0/)** | Odoo 19 development — optional `_name`, `models.Constraint` / `models.Index`, current view and frontend conventions |\n| **[Odoo Commit](skills/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 |\n| **[Flow Diagram](skills/flow-diagram/)** | Interactive self-contained HTML+SVG flow/architecture diagrams — zoom/pan, click-to-highlight flows, traveling dots, collision checkers |\n| **[DTG Base](skills/dtg-base/)** | DTGBase utilities — date/period, timezone, batch processing, barcode, Vietnamese text, file helpers |\n| **[Code Review](skills/code-review/)** | Receiving feedback, requesting reviews, and verification gates for evidence-based development |\n| **[Slide (AI Vibe Slides)](skills/slide/)** | Self-contained HTML/React slide decks for fullscreen presentation |\n\n#### Odoo reference guide topics (each version)\n\nactions · controllers · data files · decorators · development workflow · fields · manifest · migrations · mixins · models · OWL · performance · reports · security · testing · transactions · translations · views\n\n### Agents — Autonomous Reviewers\n\nSpecialized agents that act as senior technical leads:\n\n| Agent | What it does |\n|-------|--------------|\n| **[Odoo Code Review](agents/odoo-code-review/SKILL.md)** | Reviews Odoo code with scoring and structured feedback. Version-aware (16 / 17 / 18 / 19). |\n| **[Odoo Code Tracer](agents/odoo-code-tracer/SKILL.md)** | Traces execution flow from an entry point through the call graph. Version-aware (16 / 17 / 18 / 19). |\n| **[Planner](agents/planner.md)** | Breaks down complex features into actionable implementation steps |\n\n### Rules — Coding Standards\n\nEnforced patterns for consistent, secure code:\n\n| Rule | Description |\n|------|-------------|\n| **[Coding Style](rules/coding-style.md)** | Naming, imports, and code structure |\n| **[Security](rules/security.md)** | Security patterns for enterprise applications |\n\n---\n\n## Targeting an Odoo Version\n\nThe Odoo agents automatically pick the right reference pack (`skills/odoo-16.0/` … `odoo-19.0/`). Resolution order:\n\n1. **Explicit argument** passed to the agent (e.g. `odoo_version: \"19.0\"`).\n2. **Project config**, in order:\n   - `.odoo-version` at the repo root\n   - `odoo_version` in `.claude/odoo.json`\n   - `odoo.version` in `package.json`\n   - `tool.odoo.version` in `pyproject.toml`\n3. **Manifest heuristic** — dominant major version from workspace `__manifest__.py` files.\n4. **Fallback** — latest supported (`19.0`). The agent states the assumption in its output.\n\nPer-version rule deltas live in each pack's `references/api-highlights.md`. Examples:\n\n| Topic | 16.0 | 17.0 | 18.0+ |\n|-------|------|------|-------|\n| List view tag | `<tree>` | `<tree>` | `<list>` |\n| Dynamic modifiers | `attrs` / `states` | direct expressions | direct expressions |\n| Field aggregation | `group_operator=` | `group_operator=` | `aggregator=` |\n| Chatter | explicit block | explicit block | `<chatter/>` |\n\n---\n\n## Project Structure\n\n```\nagent-skills/\n├── skills/\n│   ├── odoo-16.0/             # Odoo 16 guides + api-highlights\n│   ├── odoo-17.0/             # Odoo 17 guides + api-highlights\n│   ├── odoo-18.0/             # Odoo 18 guides + api-highlights\n│   ├── odoo-19.0/             # Odoo 19 guides + api-highlights\n│   ├── odoo-commit/           # Odoo-style commit workflow and message guidance\n│   ├── flow-diagram/          # Interactive HTML+SVG flow/architecture diagrams\n│   ├── dtg-base/              # DTGBase utilities\n│   ├── code-review/           # Code review workflow\n│   └── slide/                 # HTML/React slide decks\n├── agents/\n│   ├── odoo-code-review/      # Version-aware Odoo reviewer\n│   ├── odoo-code-tracer/      # Version-aware call-graph tracer\n│   └── planner.md             # Feature planning agent\n├── rules/                     # Coding style and security\n├── bin/                       # CLI (`agent-skills`)\n├── tests/                     # Structural validator (`npm test`)\n├── .claude-plugin/            # Claude Code plugin + marketplace\n├── .github/workflows/         # CI, SkillSpector scan, release guards\n├── CHANGELOG.md\n└── lib/                       # Shared assets (images)\n```\n\n---\n\n## Supported IDEs\n\nAgent Skills works with popular AI-powered IDEs:\n\n| IDE / Tool | Install method |\n|------------|----------------|\n| **Cursor** | `npx skills add unclecatvn/agent-skills` or CLI `--ai cursor` |\n| **Claude Code** | Plugin marketplace or CLI `--ai claude` |\n| **Antigravity** | CLI `--ai antigravity` |\n| **Kiro** | CLI `--ai kiro` |\n| **Plain docs folder** | CLI `--ai docs` |\n\n---\n\n## How It Works\n\n```mermaid\nflowchart LR\n    A[Developer] -->|writes prompt| B[AI Assistant]\n    B -->|reads| C[Agent Skills]\n    C --> D[Version-pinned Odoo guides]\n    C --> E[Review agents]\n    C --> F[Security rules]\n    D --> G[Better code]\n    E --> G\n    F --> G\n    G -->|returns| A\n\n    style C fill:#4f46e5,stroke:#312e81,color:#fff\n    style G fill:#10b981,stroke:#064e3b,color:#fff\n```\n\n1. Add Agent Skills to your project (Cursor, CLI, or Claude plugin).\n2. Your AI assistant reads the relevant skill files for the task.\n3. Odoo agents resolve the target version and load the matching reference pack.\n4. You get framework-specific guidance instead of generic guesses.\n\n---\n\n## Stats\n\n| Metric | Value |\n|--------|-------|\n| Documentation | ~57,000 lines |\n| Odoo skill packs | 4 (16.0, 17.0, 18.0, 19.0) |\n| Other skill packs | 5 (DTG Base, Code Review, Odoo Commit, Flow Diagram, Slide) |\n| Agents | 3 (Odoo Code Review, Odoo Code Tracer, Planner) |\n| Rules | 2 (Coding Style, Security) |\n| Current release | [1.0.14](CHANGELOG.md) |\n| License | MIT |\n\n---\n\n## Contributing\n\nContributions are welcome:\n\n- **Improve Odoo guides** — fix errors, add examples, keep version deltas accurate\n- **Add new skill packs** — follow the structure in `skills/odoo-18.0/`\n- **Extend agents** — build specialized reviewers or planners under `agents/`\n- **Report issues** — open an issue if something is missing or broken\n\nBefore opening a PR:\n\n```bash\nnpm test          # structural validation (SKILL.md frontmatter, plugin paths, changelog)\n```\n\nCI also runs [SkillSpector](https://github.com/NVIDIA/skillspector) on `./skills/` with a baseline in `.skillspector-baseline.yaml`. Version bumps require a matching section in `CHANGELOG.md`.\n\n[![Contributors](https://img.shields.io/github/contributors/unclecatvn/agent-skills?style=flat-square)](https://github.com/unclecatvn/agent-skills/graphs/contributors)\n[![Open Issues](https://img.shields.io/github/issues/unclecatvn/agent-skills?style=flat-square)](https://github.com/unclecatvn/agent-skills/issues)\n[![Open PRs](https://img.shields.io/github/issues-pr/unclecatvn/agent-skills?style=flat-square)](https://github.com/unclecatvn/agent-skills/pulls)\n\n---\n\n## Links\n\n- [Changelog](CHANGELOG.md)\n- [Issues](https://github.com/unclecatvn/agent-skills/issues)\n- [Discussions](https://github.com/unclecatvn/agent-skills/discussions)\n- [Releases](https://github.com/unclecatvn/agent-skills/releases)\n- [npm Package](https://www.npmjs.com/package/@unclecat/agent-skills-cli)\n\n---\n\n<div align=\"center\">\n\n_If you find this project helpful, please consider giving it a star._\n\n[![Star History Chart](https://api.star-history.com/svg?repos=unclecatvn/agent-skills&type=Date)](https://star-history.com/#unclecatvn/agent-skills&Date)\n\n</div>\n",
  "bytes": 13602,
  "sha": "c034c1a3fa45dd29c6a2640820a0142aa914834d6487ab7456f263c9e914638c",
  "repo_slug": "unclecatvn/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_unclecatvn_agent_skills_odoo_18_9d06c5be/readme"
}