CtrlK
BlogDocsLog inGet started
Tessl Logo

ordoro

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

57

Quality

66%

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 ./skills/ordoro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 body is highly actionable with executable Membrane CLI commands and a mostly clear connection workflow including state-based checkpoints. Its main weaknesses are minor verbosity and a couple of broken step references that slightly muddy the workflow.

Suggestions

Trim explanatory filler such as the ecommerce-platform intro sentence, 'so you can focus on the integration logic rather than auth plumbing', and 'This will burn less tokens and make communication more secure' to improve token efficiency.

Fix the workflow numbering: label the post-connection section as 'Step 2' (referenced but missing) and reconcile the '1b' heading with a '1a' so the sequence is unambiguous.

Add an explicit verification step after running an action (e.g. check the 'output' field and confirm expected state) to close the feedback loop for batch or state-changing operations.

DimensionReasoningScore

Conciseness

The body is mostly efficient with runnable commands, but includes unnecessary prose such as the opening 'Ordoro is an ecommerce order and inventory management platform...' explainer, 'so you can focus on the integration logic rather than auth plumbing', and 'This will burn less tokens'. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened'); it is not 4 because several sentences restate what Claude already knows or could be trimmed.

3 / 5

Actionability

It provides copy-paste-ready, fully executable commands throughout (install, login, connection ensure, polling, action list/run with --input JSON, proxy with a flag table), covering the common cases with clearly marked placeholders. This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

There is a clear sequence (install -> authenticate -> ensure connection -> poll for READY / handle clientAction states -> discover -> run or proxy) with validation via state-checking and polling checkpoints. This fits anchor 4; it is not 5 because 'Step 2' is referenced but never labeled, the '1b' heading has no matching '1a', and there is no explicit verify-result step after running actions.

4 / 5

Progressive Disclosure

No bundle files exist, so all content is inline, but it is organized into clearly headed sections (Overview, Install, Authentication, Connecting, Searching, Popular actions, Best practices) that keep navigation easy. This fits anchor 4 ('Good structure; most content is appropriately placed'); it is not 5 because there are no one-level-deep references splitting out the proxy/clientAction detail, and not 3 because the structure is genuinely well organized rather than a wall of text.

4 / 5

Total

16

/

20

Passed

Description

57%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 is third-person, includes an explicit 'Use when' trigger, and names a distinctive app, but its action language is generic and its trigger-term coverage is thin. It is competent but unspecific.

Suggestions

Replace generic verbs ('Manage data, records, and automate workflows') with concrete Ordoro actions such as creating orders, syncing inventory, generating shipping labels, or managing purchase orders.

Broaden the trigger clause with natural user phrases, e.g. 'Use when the user wants to manage Ordoro orders, inventory, shipments, suppliers, or purchase orders.'

Mention key entity terms (orders, products, shipments, suppliers) so the description surfaces for the specific tasks users actually request.

DimensionReasoningScore

Specificity

Names the domain (Ordoro) but the actions 'Manage data, records, and automate workflows' are minimal and generic rather than concrete, matching anchor 2 ('Names the domain but actions are minimal or generic'). It does not reach 3 because no genuinely concrete actions (e.g. create orders, sync inventory, print shipping labels) are listed.

2 / 5

Completeness

Both a 'what' ('Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with Ordoro data') are present, matching anchor 4. It is not 5 because the 'when' is generic and lacks concrete trigger phrases, and not 3 because the 'when' is explicitly stated rather than merely implied.

4 / 5

Trigger Term Quality

It includes the specific keyword 'Ordoro' and the phrase 'interact with Ordoro data', but misses common natural variations users would say (orders, inventory, shipping, fulfillment). This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms'); it is above 2 because a real natural trigger term is present, but below 4 due to sparse synonym coverage.

3 / 5

Distinctiveness Conflict Risk

The named app 'Ordoro' gives it a clear niche with low conflict risk, fitting anchor 4 ('Mostly distinct; minor overlap risk'). It is not 5 because the surrounding action language ('manage data, records, automate workflows') is broad enough to overlap with other generic integration skills.

4 / 5

Total

13

/

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.

Validation15 / 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
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.