Agent Skills

---

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?

• Generic AI assistants give you general programming advice
• AI assistants with Agent Skills give you framework-specific, best-practice guidance

For example, instead of just getting "how to write a Python function," you get "how to write an Odoo model following Odoo 18.0 conventions with proper ORM usage."

---

Quick Start

Get started in 30 seconds with NPX (recommended):

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

Alternative: Manual Installation

# Install the CLI globally
npm install -g @unclecat/agent-skills-cli

# Initialize a specific skill (e.g., Odoo 19 for Cursor)
agent-skills init --ai cursor odoo --version 19.0

---

What's Inside?

Skills - Framework Documentation

In-depth guides written specifically for AI consumption:

Skill	Description
Odoo 18.0	Complete Odoo 18 development guide (ORM, OWL, Web Client, Performance)
Odoo 19.0	Complete Odoo 19 development guide with latest features
DTG Base	DTGBase utilities (date/period, timezone, batch, barcode, Vietnamese text)
Payment Integration	Integration guides for SePay, Polar, Stripe, Paddle, Creem.io
Code Review	Standards and protocols for automated code review
Brainstorming	Structured framework for feature ideation
Writing Skills	Guide for creating and editing AI skills
MCP Builder	Guide for building Model Context Protocol servers

Agents - Autonomous Reviewers

Specialized agents that act as senior technical leads:

Agent	What it does
Odoo Code Review	Automatically reviews Odoo code with scoring (1-10) and detailed feedback
Odoo Code Tracer	Traces execution flow from entry point to end, identifying all function calls
Odoo Module Generator	Scaffolds complete Odoo 18 modules with proper structure
Odoo Query Optimizer	Diagnoses N+1 queries and provides optimization suggestions
Odoo Migration Helper	Converts Odoo 16/17 code to Odoo 18 (tree→list, unlink→ondelete, etc.)
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-18.0/        # Odoo 18 development guide
│   ├── odoo-19.0/        # Odoo 19 development guide
│   ├── dtg-base/         # DTGBase utilities (date/period, timezone, batch)
│   ├── payment-integration/  # Payment provider integrations
│   ├── code-review/      # Code review standards
│   ├── brainstorming/    # Feature ideation framework
│   ├── writing-skills/   # Guide for creating skills
│   └── mcp-builder/      # MCP server development guide
├── agents/           # Autonomous code reviewers and planners
├── rules/            # Coding standards and security patterns
└── lib/              # Shared resources and images

---

Supported IDEs

Agent Skills works with popular AI-powered IDEs:

• Cursor - Full integration via CLI
• Claude Code - Native skill support
• Windsurf - Compatible
• Aider - Compatible

---

How It Works

graph LR
    A[Your AI Assistant] --> B[Reads Agent Skills]
    B --> C[Framework Knowledge]
    B --> D[Best Practices]
    B --> E[Code Patterns]
    C --> F[Better Code Suggestions]
    D --> F
    E --> F

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	10,000+ lines
Skill Packs	8 (Odoo 18.0, 19.0, DTG Base, Payment, Code Review, Brainstorming, Writing, MCP)
Agents	6 (Code Review, Tracer, Module Generator, Query Optimizer, Migration Helper, 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

See CONTRIBUTING.md for guidelines.

---

Links

• Issues
• Discussions
• Releases

---

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