odoo-docslisted
Install: claude install-skill tuanle96/odoo-ai-skills
# odoo-docs — Local Developer Doc Index
Offline TF-IDF search over Odoo developer documentation, built once from the
official `odoo/documentation` repository (CC-BY-SA-4.0, © Odoo S.A.).
The index lives at `~/.odoo-ai/docs-index/<version>/index.json` — outside this
repo, never committed. Every result links to the canonical odoo.com page.
## One-time build
```bash
# Best-effort: sparse-clones odoo/documentation (branch 18.0) via git
odoo-ai docs-build --version 18
# From a local checkout (no network needed):
odoo-ai docs-build --version 18 --src /path/to/odoo/documentation
```
The index is a derived artifact under CC-BY-SA-4.0. Rebuild whenever you
upgrade Odoo or want fresher docs. Building takes ~1–2 min on the first run.
## Query
```bash
odoo-ai docs "ORM create method" --version 18
odoo-ai docs "computed field dependencies" --version 18 --top 10
```
Output JSON includes `results[].url` pointing to canonical odoo.com pages and
a `_caveat` reminding you to existence-gate against the live instance:
```json
{
"query": "...",
"version": "18",
"results": [
{
"heading": "Fields Reference",
"rel_path": "content/developer/reference/backend/orm.rst",
"anchor": "fields-reference",
"score": 0.72,
"preview": "Fields define the columns of a model ...",
"url": "https://www.odoo.com/documentation/18.0/developer/reference/backend/orm.html#fields-reference"
}
],
"_caveat": "Docs say how the API SHOULD work; introsp