CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-api-management

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

Quality

69%

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/azure-api-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 strongly actionable CLI workflow guide with a real validation feedback loop around connection states, undermined slightly by a concept-explaining intro paragraph, an empty "Popular actions" section, and a dangling "Step 2" reference. Tightening those would move it into excellent territory.

Suggestions

Delete the intro paragraph explaining what Azure API Management is — Claude already knows this — and keep only the official docs link.

Fix the broken step numbering: either label the steps explicitly (Step 1: connect, Step 2: wait/verify, Step 3: run actions) or remove the "skip to **Step 2**" and "1b" references to the undefined step.

Populate the "Popular actions" section with 3-5 actual APIM action examples (e.g. list APIs, get subscription, update policy) or remove the heading, since it currently promises actions but delivers only the generic discovery command.

DimensionReasoningScore

Conciseness

The opening paragraph ("Azure API Management helps organizations publish, secure, transform, and analyze their APIs. It's used by developers and businesses...") explains a concept Claude already knows, and "Use action names and parameters as needed" is filler. The rest is mostly compact commands, so this sits at 'mostly efficient but includes some unnecessary explanation' rather than clearly efficient.

3 / 5

Actionability

Nearly all guidance is copy-paste executable: `npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://..."`, the `--wait` polling command, `action run` with `--input '{"key": "value"}'`, and a full proxy flag table. Not a 5 because the "## Popular actions" section lists zero actual actions (only the generic discovery command) and there is no worked end-to-end example with real parameter values.

4 / 5

Workflow Clarity

The sequence is discernible (install → login → connect → poll state → handle clientAction → search actions → run → proxy fallback) and includes a genuine feedback loop (poll BUILDING, handle CLIENT_ACTION_REQUIRED, re-poll after user action, check the error field on CONFIGURATION_ERROR). Not a 5 because "skip to **Step 2**" references a step that is never defined, the section numbering is broken (a "1b" with no labeled step 1 or 2), and there is no verification step for action output.

4 / 5

Progressive Disclosure

A single-file skill (no references/, scripts/, or assets/ bundle) with clear, well-ordered section headers and no buried or nested references. Not a 5 because at ~155 lines, content that would fit a reference file — the proxy flags table and the connection-state/clientAction field documentation — is inlined in the main file.

4 / 5

Total

15

/

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 has a clear, well-scoped trigger clause naming a specific product, but its capability statement is generic template boilerplate that could describe any SaaS integration. Replacing the boilerplate with concrete APIM capabilities (publish APIs, manage policies, subscriptions, products, backends) would substantially improve it.

Suggestions

Replace the generic "Manage data, records, and automate workflows" with APIM-specific capabilities, e.g. "Publish and secure APIs, manage products, subscriptions, policies, backends, and named values."

Add natural trigger keywords and synonyms users actually say: "APIM", "API gateway", "developer portal", "API policies", so the skill surfaces for varied phrasings.

Make the "Use when" clause enumerate concrete situations, e.g. "Use when the user wants to publish or modify APIs in Azure API Management, configure policies or subscriptions, or debug an APIM gateway."

DimensionReasoningScore

Specificity

The description names the domain ("Azure API Management integration") but the only actions offered are generic boilerplate ("Manage data, records, and automate workflows") with no APIM-specific concrete actions like publishing APIs, policies, subscriptions, or gateways — matching the anchor 'names the domain but actions are minimal or generic'. It is not a 3 because no domain-specific concrete action is stated.

2 / 5

Completeness

Both halves are explicitly present: a "what" ("Manage data, records, and automate workflows") and an explicit trigger clause ("Use when the user wants to interact with Azure API Management data"), so the missing-'Use when' cap at 3 does not apply. It is not a 5 because the "what" is vague boilerplate rather than concrete capabilities, and the "when" could name specific APIM tasks.

4 / 5

Trigger Term Quality

"Azure API Management" is the actual product name and appears twice, but there are no natural variations or synonyms users would say — "APIM", "API gateway", "policies", "subscriptions" — matching 'some relevant keywords but missing common variations'. Not a 4 because keyword coverage is effectively one term.

3 / 5

Distinctiveness Conflict Risk

The Use-when clause scopes triggering tightly to a specific Azure product, giving a clear niche with minimal conflict risk. Not a 5 because the boilerplate middle sentence ("Manage data, records, and automate workflows") is shared across whole families of integration skills and does not differentiate this skill from sibling Azure or Membrane 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.

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/azure-api-management/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.