CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

odoo-shopify-integration

Connect Odoo with Shopify: sync products, inventory, orders, and customers using the Shopify API and Odoo's external API or connector modules.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/odoo-shopify-integration/SKILL.md

The canonical home for this skill is odoo-shopify-integration in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

68%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, mostly executable skill body with a clear data-flow model and honest best practices. Its weakest point is workflow safety: webhook processing and order creation lack validation checkpoints and error-recovery loops, and the code examples have correctness gaps (silent `False` on unmatched SKUs, HMAC validation mentioned but not implemented).

Suggestions

Add validation steps to the order-sync workflow: verify the webhook HMAC signature in code before processing, check that every SKU resolves to an Odoo product before creating the order, and define what happens on failure (skip-and-log vs. retry queue).

Fix the code gap where `get_odoo_product_id` returns `False` for unknown SKUs — create the product from the Shopify payload or reject the order explicitly instead of letting `False` crash order-line creation.

Move the full code examples or the field-mapping details into a references/ file and keep SKILL.md as a leaner overview, freeing context for the conversation.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — it does not explain what Odoo or Shopify are, and the data-flow diagram is dense and useful. Minor trimming is possible: the "How It Works" section ("Mention @odoo-shopify-integration...", "Receive the data flow architecture") is conversational filler about the interaction ritual rather than technical content. It does not reach 5 because that section and some emoji-decorated best-practice lines spend tokens that earn less than a tighter formulation would.

4 / 5

Actionability

Two concrete, near-executable Python examples with real Odoo XML-RPC calls and a Flask webhook handler cover the central order-sync case. Gaps keep it from 5: `get_odoo_product_id` returning `False` on unknown SKUs would crash order-line creation, the webhook code omits the HMAC validation the best-practices section mandates, and the headline use cases of inventory sync and variant mapping have no code at all.

4 / 5

Workflow Clarity

The sequence is present (data-flow diagram plus the Activate/Design/Build list), but there are no validation checkpoints or error-recovery loops anywhere: no HMAC verification step in the webhook flow, no handling of unmatched SKUs or missing customers, and no retry/queue guidance for failed order creation. Webhook-driven order creation is a batch operation, and per the judging guidelines missing validation caps workflow clarity at 3 even though the listed flows are easy to follow.

3 / 5

Progressive Disclosure

The single SKILL.md is well-organized into Overview, When to Use, Data Flow, Examples, and Best Practices with no bundle files to navigate, so navigation is trivial. It sits at 4 rather than 5 because the under-50-line exception does not apply (~100 lines): the two full code examples and field-mapping details could be split into references/ files to keep the overview lean, a minor organization gap.

4 / 5

Total

15

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, well-scoped description with strong trigger terms and near-zero conflict risk, weakened only by the complete absence of an explicit "Use when" clause. Adding trigger guidance would likely lift it to a top-tier description.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions Odoo, Shopify, syncing inventory or orders between an online store and an ERP, or building an e-commerce integration."

Include natural synonyms users might say, such as "Shopify store", "online store", or "e-commerce platform integration", to broaden trigger coverage.

Optionally mention webhooks or real-time sync in the description so users describing event-driven scenarios match the skill.

DimensionReasoningScore

Specificity

The description lists four concrete actions ("sync products, inventory, orders, and customers") plus the mechanisms ("using the Shopify API and Odoo's external API or connector modules"), giving comprehensive coverage of the integration domain. It does not fall to 4 because the four sync targets cover the core entities an Odoo↔Shopify integration touches with no notable capability gaps stated at this level.

5 / 5

Completeness

The "what" is clear (sync products, inventory, orders, customers between Odoo and Shopify), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is entirely absent. Per the judging guidelines a missing 'Use when' clause caps completeness at 3; it stays above 2 because the "what" is concrete and unambiguous.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "Connect Odoo with Shopify", "sync products, inventory, orders, and customers", "Shopify API", "connector". It misses common variations like "Shopify store", "e-commerce integration", or "webhooks", so it does not reach the comprehensive synonym/extension coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

"Connect Odoo with Shopify" carves out a clear niche with distinct, co-occurring trigger terms (Odoo, Shopify) that virtually no other skill would match, minimizing conflict risk. No overlap concerns — the anchors at 4 (minor overlap with closely related skills) do not apply since the two-platform pairing is unique.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/odoo-shopify-integration/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.