Odoo OCA Developer Skill for Skills.sh

1. Main Skill (odoo-oca-developer)

Location:

• Development directory: ~/Workspaces/odoo-oca-convention-skill/odoo-oca-developer/
• Global installation: ~/.copilot/skills/odoo-oca-developer.skill (54 KB)

Structure:

odoo-oca-developer/
├── SKILL.md                          (406 lines - main guide)
├── scripts/
│   ├── init_oca_module.py           (Script to create modules)
│   └── validate_module.py           (Script to validate modules)
├── references/
│   ├── oca_conventions.md           (342 lines - OCA conventions)
│   └── openupgrade_migration.md     (315 lines - migration guide)
└── assets/
    └── module_template/             (Official OCA template)

2. Reference Documentation

oca_conventions.md (342 lines)

Complete OCA conventions guide:

• Module naming conventions
• Complete directory structure
• __manifest__.py requirements
• Python code structure
• XML conventions
• Installation hooks
• Git commit messages
• Security and testing patterns

openupgrade_migration.md (315 lines)

OpenUpgrade migration guide:

• Pre/post migration scripts
• Common migration patterns
• Field, model, and table renaming
• Data transformation
• Value mapping
• OpenUpgrade API functions
• Best practices
• Common patterns

SKILL.md (406 lines)

Main skill guide:

• 5 core capabilities
• Workflow decision tree
• Code examples
• Module validation
• Common patterns
• Troubleshooting
• Quick references

3. Executable Scripts

init_oca_module.py

• Creates new modules with complete OCA structure
• Validates module names
• Replaces placeholders in files
• Provides next steps instructions

Usage:

python scripts/init_oca_module.py my_module --path ./addons --version 17.0

validate_module.py

• Validates module structure
• Checks required files
• Verifies OCA compliance
• Validates naming conventions
• Reviews manifest configuration

Usage:

python scripts/validate_module.py /path/to/module

4. Module Template

Complete copy of the official OCA template including:

• Complete directory structure
• Example files
• Security configuration
• Test structure
• Static assets organization
• Report examples
• Migration examples

🚀 Skill Capabilities

The skill enables:

1. Create Odoo modules from OCA template
2. Migrate modules between versions (14.0-19.0) using OpenUpgrade
3. Extend Odoo core modules
4. Validate compliance with OCA conventions
5. Structure files correctly

💡 Use Cases

The skill answers questions like:

• "I need to create an Odoo 17 module"
• "Help me migrate this module from Odoo 16 to version 19"
• "Help me extend the 'event' module to create a new module following OCA conventions"
• "Does my module follow OCA conventions?"
• "What is the correct structure for an Odoo module?"

📊 Project Statistics

Component	Lines	Size
SKILL.md	406	Main
oca_conventions.md	342	Reference
openupgrade_migration.md	315	Reference
Total documentation	1,063	-
Final .skill file	-	54 KB
Module template	Complete	+50 files

✨ Special Features

Standards-compliant skill

• ✅ Valid YAML frontmatter
• ✅ Clear and complete description
• ✅ Well-organized references
• ✅ Documented executable scripts
• ✅ Module template included

English content

• ✅ All skill code in English
• ✅ Technical documentation in English
• ✅ Code examples in English
• ✅ OCA conventions (original language)

Complete coverage

• ✅ Module creation
• ✅ Version migration
• ✅ Module extension
• ✅ Compliance validation
• ✅ Best practices
• ✅ Common patterns
• ✅ Troubleshooting

🛠 How to Use the Skill

1. Simply ask anything related to OCA Odoo development
2. Use the scripts to create and validate modules
3. Reference the guides to learn conventions
4. Follow the patterns to migrate or extend

📁 Locations

Development

~/Workspaces/odoo-oca-convention-skill/
├── odoo-oca-developer/         (Main skill directory)
├── SKILL_GUIDE.md              (Complete usage guide)
└── README.md                   (This file)

Global Installation

~/.copilot/skills/odoo-oca-developer.skill

📚 Consulted Resources

• OCA Contribution Guidelines: https://github.com/OCA/odoo-community.org
• OCA Maintainer Tools: https://github.com/OCA/maintainer-tools
• OpenUpgrade: https://github.com/OCA/OpenUpgrade
• OpenUpgrade Documentation: https://oca.github.io/OpenUpgrade/

✅ Completion Checklist

• [x] Skill initialized with init_skill.py
• [x] SKILL.md written with complete guide
• [x] OCA references created (2 files)
• [x] Functional scripts developed (2 scripts)
• [x] OCA module template included
• [x] Examples documentation
• [x] Validation completed
• [x] Skill packaged successfully
• [x] Installed in ~/.copilot/skills/
• [x] User guide created
• [x] All documentation in English

🎓 Step-by-Step Implementation

1. ✅ Understanding skill-creator
2. ✅ OCA conventions research
3. ✅ Official OCA template download
4. ✅ Skill initialization with structure
5. ✅ Complete references creation
6. ✅ Executable scripts development
7. ✅ Main SKILL.md writing
8. ✅ Structure validation
9. ✅ Skill packaging
10. ✅ Global installation on Copilot
11. ✅ Complete English documentation

🔄 Optional Next Steps

• Create version-specific migration skill
• Add automatic linting validation
• Include report templates
• Add advanced testing patterns
• Create OCA contribution guide

📞 Frequently Asked Questions

Q: Where is the skill installed?
A: At ~/.copilot/skills/odoo-oca-developer.skill and in the development directory.

Q: How do I use the skill?
A: Just ask Copilot about Odoo development and it will mention the skill automatically.

Q: Can I modify the skill?
A: Yes, edit files in the development directory and repackage with package_skill.py.

Q: Is it compatible with all Odoo versions?
A: The skill covers Odoo 14.0-19.0 as per original requirements.

Q: Is everything in English?
A: Yes, all code and technical documentation is in English as requested.

---

The skill is ready to use

For more details, see SKILL_GUIDE.md