CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

higress-gateway-management

Manage the Higress AI Gateway via its Console API (consumers, routes, AI providers, MCP servers). Use when creating consumers, configuring routes, or managing AI gateway settings.

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A strong, execution-first reference: complete curl recipes for every resource type plus genuinely non-obvious operational knowledge (cookie auth, version-field semantics, route-predicate strategy). The gaps are missing verification around destructive DELETE operations and an unadvertised bundle reference file.

Suggestions

Add validation steps around destructive operations: verify the consumer/route exists before DELETE, and check the response body for success before reporting completion (e.g., pipe responses through jq and inspect the error field).

Reference references/higress-api-doc.json explicitly in the body (e.g., a line under Overview or Important Notes: 'Full API schema: see references/higress-api-doc.json') so the bundled OpenAPI spec is discoverable and endpoint details can be offloaded from SKILL.md.

De-duplicate the MCP-server pointer and the version-field caveats, which each appear twice (in code comments/section text and again in Important Notes).

DimensionReasoningScore

Conciseness

The body is almost entirely copy-paste curl commands with short, high-value notes (session-cookie vs Basic Auth, version-field semantics, ~40s activation delay) and no padding or explanations of concepts Claude already knows. Minor trimming is possible — the MCP-server delegation and the version-field caveats are each stated twice (in code comments and again in Important Notes) — so it sits just below the every-token-earns-its-place anchor.

4 / 5

Actionability

Every operation ships as a complete, executable curl command with real JSON payloads, environment-variable wiring, and jq transforms for the GET-modify-PUT pattern (e.g., the consumer key-rotation and allowedConsumers update blocks). Copy-paste ready and covering list/create/update/delete across consumers, AI routes, and providers.

5 / 5

Workflow Clarity

Sequences are shown with numbered steps for the fragile update flows ("Step 1: GET ... Step 3: PUT full object"), which is good, but the skill includes destructive operations (DELETE consumer, DELETE AI route) with no validation or verification steps — no existence check before delete and no success/error check of responses — which caps this dimension at 3 per the rubric's destructive-operations rule.

3 / 5

Progressive Disclosure

The body is well-sectioned and appropriately delegates MCP servers to the mcp-server-management skill, but the bundle file references/higress-api-doc.json (a 185KB OpenAPI spec, the natural home for endpoint details) is never mentioned anywhere in SKILL.md, so the reference exists but is not signaled or navigable — the 'references present but not clearly signaled' anchor.

3 / 5

Total

15

/

20

Passed

Description

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

A well-formed description: concrete domain, explicit resources, and a clear 'Use when' clause with natural trigger phrases. Its only weaknesses are a generic lead verb ("Manage"), a few missing synonyms, and slight overlap with the separate MCP-server skill.

DimensionReasoningScore

Specificity

"Manage the Higress AI Gateway via its Console API (consumers, routes, AI providers, MCP servers)" names the domain, the concrete mechanism (Console API), and four concrete managed resources, and the trigger clause adds specific actions ("creating consumers, configuring routes"). Not quite a 5 because the leading verb stays generic ("Manage ... settings") and per-resource actions like delete/update are not enumerated, but it clearly exceeds the 1-2-action anchor at level 3.

4 / 5

Completeness

It explicitly answers both questions: what ("Manage the Higress AI Gateway via its Console API (consumers, routes, AI providers, MCP servers)") and when ("Use when creating consumers, configuring routes, or managing AI gateway settings"), mirroring the top anchor's what+when structure with concrete trigger phrases. The 'when' clause is explicit and specific, so this is not the level-4 case of a merely adequate trigger clause.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present — "creating consumers", "configuring routes", "AI gateway settings", "MCP servers", "AI providers". Missing a few common variations (e.g., "add a provider", "API key", "credentials", "LLM routing"), which keeps it below the comprehensive-synonym anchor at 5.

4 / 5

Distinctiveness Conflict Risk

"Higress AI Gateway" and "Console API" carve out a clear niche that virtually no other skill would claim, and triggers like "creating consumers" or "configuring routes" are scoped to that gateway. Minor overlap risk remains because the description mentions "MCP servers", which the body delegates to a separate mcp-server-management skill, so an MCP-related request could trigger both.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

agentscope-ai/AgentTeams

Path

manager/agent/skills-alpha/higress-gateway-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.