CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

akamai

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

Quality

65%

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/akamai/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 solid, command-first integration guide with a genuinely well-handled connection lifecycle (state machine, polling, client-action handling) and a sensible actions-first/proxy-fallback strategy. Its main flaws are a small amount of known-concept padding and cosmetic incoherence — inconsistent CLI invocation and a "Step 2" reference that doesn't exist — rather than structural problems.

DimensionReasoningScore

Conciseness

Mostly efficient command-driven guidance, but it opens by explaining what a CDN is ("Akamai is a content delivery network (CDN)... improve the speed and reliability of their websites") — a concept Claude already knows — plus filler like "Use action names and parameters as needed" and the loosely worded "Agent Types" aside. Not a 2 because the padding is limited to a few lines rather than whole sections.

3 / 5

Actionability

Nearly all guidance is copy-paste executable: "npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://akamai.com\" --json", "membrane action run <actionId> --connectionId=... --input '{...}'", and a concrete proxy flag table. Not a 5 because the CLI invocation is inconsistent ("membrane" vs "npx @membranehq/cli connection get") and the dangling "Step 2" reference leaves the reader to infer the next command's label.

4 / 5

Workflow Clarity

A clear install → login → connect → poll → search → run → proxy sequence with real checkpoints: state-based branching (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), --wait polling, and a re-poll feedback loop after user action. Not a 5 because "skip to Step 2" points at a heading that is never labeled (there is no Step 1a/1b/2 numbering scheme), a minor coherence gap.

4 / 5

Progressive Disclosure

A single well-sectioned ~157-line file with no bundle directories; headings (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) make navigation easy and nothing is deeply nested. Not a 5 because it exceeds the under-50-line simple-skill case and parts (the 20-item resource taxonomy, the full CLI/proxy reference) could live in reference files, though no references are buried or misleading.

4 / 5

Total

15

/

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 anchors on the Akamai niche and includes an explicit "Use when" clause, but the capability statement is generic fluff ("manage data, automate workflows") with no concrete actions or natural trigger terms from Akamai's actual surface (CDN, DNS, certificates, security). It reads like a template description with the domain name substituted.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete capabilities drawn from the skill's own resource list, e.g. "Manage DNS zones and records, certificates, traffic management, security policies, and firewall configurations via the Akamai API."

Expand the trigger clause with natural user phrasing: "Use when the user mentions Akamai, its CDN, DNS zones/records, edge delivery, or Akamai certificates and security policies."

Use third-person imperative verb forms consistently ("Manages...", "Runs...") and drop filler like "automate workflows" that adds no scannable information.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the domain (Akamai) but the actions are minimal or generic — "manage data" and "automate workflows" are buzzword-level rather than concrete operations. Not a 3 because it never states specific actions like managing DNS zones, issuing certificates, or listing security policies.

2 / 5

Completeness

The "when" is explicit ("Use when the user wants to interact with Akamai data") but the "what" is vague ("Manage data, records, and automate workflows"), so the pairing falls short of the anchor-4 example where both are present and only the when is improvable. Not a 2 because a when clause does exist and the domain is named.

3 / 5

Trigger Term Quality

"Akamai" and "records" are relevant keywords a user would naturally say, similar to "Works with PDF files". Not a 4/5 because common natural terms from the skill's actual scope (CDN, DNS, certificates, traffic management, edge, security policies) are absent.

3 / 5

Distinctiveness Conflict Risk

"Akamai integration... interact with Akamai data" carves out a clear, well-defined niche with minimal conflict against unrelated skills. Not a 5 because the only distinctive trigger is the brand name; a request like "manage my DNS records" or "renew certificates" gives no signal to pick this skill over a generic DNS/certificate skill.

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