CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

amadeus

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

Quality

61%

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

Quality

Content

57%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 a largely executable guide to the Membrane CLI workflow for Amadeus, with strong command coverage (install, auth, connection lifecycle, action discovery/execution, proxy fallback) and useful error-state handling. Its weaknesses are structural: a dangling 'Step 2' reference with no numbered steps, a duplicated/empty 'Popular actions' section, and buzzword filler (company description, generic action-name list) that spends tokens without adding guidance. Splitting connection-state and proxy detail into reference files would tighten the main file considerably.

Suggestions

Fix the broken step numbering: either add explicit '### Step 1' / '### Step 2' headings so 'skip to **Step 2**' resolves, or rewrite the references to point at the actual section names ('Searching for actions').

Remove the duplicate 'Popular actions' section (or populate it with 3-5 concrete action examples) and delete the company-description paragraph and 'Use action names and parameters as needed' filler line.

Move the clientAction state semantics and the proxy flags table into a references/ file, keeping SKILL.md as a lean overview with one-line links.

DimensionReasoningScore

Conciseness

Mostly efficient — CLI commands, a flags table, and connection-state handling — but padded with unnecessary material: a corporate-description opener ('Amadeus is a technology company providing IT solutions...'), a bare feature-name bullet list ending in the filler line 'Use action names and parameters as needed', and the same 'action list' command duplicated under both 'Searching for actions' and 'Popular actions'. Fits 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not 4 because the redundancy and boilerplate are more than minor.

3 / 5

Actionability

Concrete, copy-paste-ready commands throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://amadeus.com" --json', 'membrane action run <actionId> --connectionId=... --input', plus a complete proxy-options table and headless login completion flow. Minor gaps keep it at anchor 4 rather than 5: the 'Popular actions' section contains no actual example actions or intents.

4 / 5

Workflow Clarity

The install → login → connect → poll → act → proxy sequence is present with real error-handling guidance (clientAction handling, CONFIGURATION_ERROR → check 'error' field, re-poll loop). But the flow says 'skip to **Step 2**' when no Step 2 (or Step 1) heading exists — only an orphaned '#### 1b' — leaving the sequence with genuine gaps. Steps listed with sequence gaps → anchor 3, not 4.

3 / 5

Progressive Disclosure

No bundle files exist, and the ~160-line body has reasonable section headers but inlines content that belongs in reference files (the clientAction state semantics, the proxy options table), plus a duplicated section and an empty 'Popular actions' header. Being well over the 50-line simple-skill threshold with these organization issues fits 'Some structure but could be better organized' — anchor 3 rather than 4.

3 / 5

Total

13

/

20

Passed

Description

48%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 identifies the niche (Amadeus) and includes an explicit 'Use when...' trigger, but its capability statement is generic buzzwords that convey nothing about the travel-domain actions (flight/hotel/transfer/car/train search, pricing, booking) the skill actually supports. It would rarely trigger for the wrong skill, but it also gives Claude little basis to prefer it or know what it does.

Suggestions

Replace 'Manage data, records, and automate workflows' with concrete Amadeus capabilities, e.g. 'Search and book flights, hotels, transfers, car rentals, and trains via the Amadeus API'.

Add natural trigger terms users would actually say — 'flights', 'airfare', 'hotel booking', 'travel itinerary', 'Amadeus API' — to the 'Use when...' clause.

Mirror the body's actual capability surface (the Amadeus Overview list) so the description matches what the skill can do.

DimensionReasoningScore

Specificity

The description names the domain ("Amadeus integration") but the actions are pure buzzword filler — "Manage data, records, and automate workflows" — with no concrete capability (flights, hotels, transfers, bookings) that the skill body actually covers. This matches the anchor 'Names the domain but actions are minimal or generic'; it falls short of 3 because not even one concrete action is named.

2 / 5

Completeness

Both 'what' and 'when' are present, and the 'Use when the user wants to interact with Amadeus data' clause is an explicit trigger. However, the 'what' half ("Manage data, records, and automate workflows") is vague fluff, so the pair falls between anchors 3 and 4, landing at 3 rather than noticeably above the midpoint.

3 / 5

Trigger Term Quality

"Amadeus" is one strong, natural proper-noun keyword, but the remaining terms ("data", "records", "workflows") are generic, and common natural phrases a user would say — flights, airfare, hotel booking, travel itinerary, Amadeus API — are entirely missing. Fits 'Some relevant keywords but missing common variations or synonyms'; not 4 because those variations are absent.

3 / 5

Distinctiveness Conflict Risk

"Amadeus" is a clear niche with a distinct trigger term and minimal wrong-skill risk, but the generic 'manage data / automate workflows' phrasing overlaps with many integration skills. Mostly distinct with minor overlap risk — anchor 4; not 5 because only the proper noun, not the surrounding trigger language, provides the distinctiveness.

4 / 5

Total

12

/

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