CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

akeneo

Akeneo integration. Manage data, records, and automate workflows. Use when the user wants to interact with Akeneo data.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/akeneo/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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.

The skill is a solid, command-driven integration guide: nearly every section contains executable membrane CLI commands, and the connection setup includes an unusually well-specified state machine with polling and error handling. Its weaknesses are padding (the PIM explainer and bare entity list), a misleading "Popular actions" section with no concrete Akeneo example, and a dangling "Step 2" cross-reference that breaks the workflow's navigability.

Suggestions

Delete the entity bullet tree and "Use action names and parameters as needed." filler; replace with one line noting that actions are discovered dynamically via `membrane action list --intent`.

Fix the broken cross-references: either number the workflow steps explicitly (1a install/login, 1b wait, 2 search actions, 3 run) or remove the "skip to Step 2" and "1b" labels.

Add a concrete "Popular actions" example, e.g., an actual Akeneo action run such as listing products with a real action id and --input payload, plus a note to check the output field for errors before proceeding with batch record updates.

DimensionReasoningScore

Conciseness

The body is mostly executable command guidance, but several sections are unnecessary or padded: the opening PIM explainer ("It helps businesses collect, manage, and enrich product information, then distribute it to various sales and marketing channels"), the bare entity bullet tree with the filler line "Use action names and parameters as needed.", and redundant prose like "This is the fastest way to get a connection.". This fits anchor 3 ("Mostly efficient but includes some unnecessary explanation or could be tightened") — more than minor trimming is needed, so not 4, but the bulk is lean commands, so not 2.

3 / 5

Actionability

Concrete copy-paste-ready commands appear throughout ("npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://akeneo.com\" --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json") plus a flags table for proxy requests. This is anchor 4 rather than 5 because the "Popular actions" section promises specifics but only repeats the generic discovery command — no concrete Akeneo action example with a real action id and input is shown.

4 / 5

Workflow Clarity

The connection setup has good checkpoints — explicit state handling for READY, CLIENT_ACTION_REQUIRED with the clientAction.type/description/uiUrl/agentInstructions fields, CONFIGURATION_ERROR/SETUP_FAILED, and poll-again instructions after the user acts. But the overall sequence has real gaps: "If the returned connection has state: \"READY\", skip to **Step 2**" points to a section that does not exist, "#### 1b" has no "1a", and there is no validation of action results despite this being a record-management skill where batch CRUD operations occur. This fits anchor 3 ("Steps listed but validation gaps; sequence present but checkpoints missing or implicit") rather than 4 — the dangling cross-reference and absent result verification are more than minor gaps.

3 / 5

Progressive Disclosure

No bundle files exist, so everything lives in a single ~150-line file with clear ##/### headers, no nested references, and nothing buried — matching anchor 4 ("Good structure; most content is appropriately placed; minor organization gaps"). It is below 5 because it exceeds the simple-skill (<50 lines) exception and sections like the entity overview list and clientAction schema breakdown could be split or trimmed, but above 3 because organization is navigable and nothing that must be separate is inlined in a harmful way.

4 / 5

Total

14

/

20

Passed

Description

61%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.

The description correctly uses third-person voice and includes an explicit "Use when..." clause, giving it solid completeness and distinctiveness. However, the capability statement is generic buzzword-level ("Manage data, records, and automate workflows") with no concrete Akeneo actions or objects, and the only trigger keyword is the product name itself with no synonyms like PIM or product catalog.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete Akeneo capabilities, e.g., "Manage products, categories, families, and attributes; search and update product catalogs; run Akeneo API actions".

Add natural trigger synonyms such as "PIM", "product catalog", or "product information management" so users describing the task without naming Akeneo still match.

Make the "Use when" clause more specific about scenarios, e.g., "Use when the user wants to query, create, or update Akeneo product data or catalog records".

DimensionReasoningScore

Specificity

The description names the domain ("Akeneo integration") but the actions are minimal and generic — "Manage data, records, and automate workflows" contains no Akeneo-specific objects or operations (e.g., products, categories, families, attributes). It matches anchor 2 ("Names the domain but actions are minimal or generic") rather than 3, since not even one concrete Akeneo action is stated.

2 / 5

Completeness

Both elements are present: what = "Manage data, records, and automate workflows" and when = "Use when the user wants to interact with Akeneo data". It fits anchor 4 rather than 5 because the "what" is vague and the "when" merely restates the trigger instead of adding concrete trigger phrases; it is above 3 because the "when" is explicit, not merely implied.

4 / 5

Trigger Term Quality

The only natural keyword is "Akeneo" (repeated three times); the description omits common variations and synonyms a user would say, such as "PIM", "product catalog", or "product information". This fits anchor 3 ("Some relevant keywords but missing common variations or synonyms"), not 4 — coverage beyond the product proper noun is absent.

3 / 5

Distinctiveness Conflict Risk

Akeneo is a specific named PIM product and the trigger ("interact with Akeneo data") is distinct, giving it a clear niche with minimal conflict risk against other skills — matching anchor 5.

5 / 5

Total

14

/

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

membranedev/application-skills

Path

skills/akeneo/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.