CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ops-inspector

AIOps-style CloudBase inspection skill. Use when users need health checks, log diagnosis, alarm interpretation (CPU alert normal?, peak QPS), metrics via queryEnv(action=metrics), fault playbooks for 429 / AI model 429 / function timeout / function 404 / ACCESS_TOKEN_INVALID / zero invocations, or a scheduled patrol that reports only new or worse findings. Triggers on 巡检, 诊断, 告警, 峰值 QPS, 限频, 调用量为 0, 定时巡检, 每天检查, 值守, troubleshooting.

Quality

93%

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

The canonical home for this skill is ops-inspector in TencentCloudBase/CloudBase-AI-Toolkit

SKILL.md
Quality
Evals
Security

Quality

Content

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

An unusually actionable diagnostic skill: exact tool calls, verified query syntax, sequenced workflows with validation gates, and a genuinely useful scheduled-patrol design. The main costs are token efficiency — duplicated caveats and long inline lookup tables — and those tables belonging in reference files rather than the main body.

Suggestions

Move the QCE/POSTGRES metric-name enumeration (in the Targeted Inspection database section) and the Common CLS Query Patterns table into a reference file (e.g. references/metric-and-query-catalog.md), keeping only the 3–4 highest-frequency patterns inline — this would improve both conciseness and progressive disclosure.

State the queryEnv-has-no-PostgreSQL-metrics exception once (in the Preferred Tool Map or the database routing line) and reference it from the other spots instead of repeating the full callCloudApi fallback path in three places.

Deduplicate the per-directory credential-resolution note ("Activation Contract → Common mistakes" vs. "Minimal checklist") into a single gotcha entry.

DimensionReasoningScore

Conciseness

Nearly every line is non-generic operational knowledge (exact tool actions, verified query-syntax gotchas, baselines, patrol state rules) rather than concepts Claude already knows, but there is noticeable duplication that could be trimmed: the queryEnv-has-no-PG-metrics exception appears in "Do NOT use for", "Common mistakes", and the Targeted workflow, and the per-directory credential note appears twice. Mostly efficient with minor over-explanation — fits the 4 anchor, not the 3 anchor's "some unnecessary explanation", and not the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Fully executable throughout: exact MCP calls with parameters ("queryEnv(action=\"metrics\", envId=\"<EnvId>\", metricName=\"GatewayTraceEnvQPS\")"), copy-paste CLS query strings per scenario ("status_code:>202 | select function_name, count(*) as c group by function_name limit 20"), a concrete report template, a state-file schema with field names, and console URL patterns. Common cases are covered with specific examples.

5 / 5

Workflow Clarity

The Full Inspection Workflow is a clearly ordered 7-step sequence with validation gates (Step 1 environment check before anything else, Step 3 checkLogService before log aggregation) and error-recovery branches (binding failure → credential resolution doc; CLS disabled → warn and recommend enabling). A pre-flight Minimal Checklist, per-mode routing table, and the patrol's read-only/auth-valid/silent-on-clean rules add explicit checkpoints — matching the top anchor rather than the most-checkpoints-with-minor-gaps anchor.

5 / 5

Progressive Disclosure

Two real, clearly-signaled, one-level-deep references ("references/alarm-interpretation.md", "references/fault-playbooks.md") plus well-labeled sibling-skill routing, and the body is organized with headers and tables for easy navigation. However some reference-grade material is inlined in SKILL.md — the full QCE/POSTGRES metric enumeration (dozens of metric names in the Targeted workflow) and the 13-row CLS query-pattern table — which is exactly the "bulk could live in a separate file" pattern of the 4 anchor rather than the cleanly split 5 anchor.

4 / 5

Total

18

/

20

Passed

Description

96%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 strong description: concrete capabilities, an explicit use-when clause, and a rich bilingual trigger list that includes natural user phrasings. The only improvement would be dropping or qualifying the generic "troubleshooting" trigger to further reduce overlap with sibling diagnostic skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "health checks, log diagnosis, alarm interpretation (CPU alert normal?, peak QPS), metrics via queryEnv(action=metrics), fault playbooks for 429 / AI model 429 / function timeout / function 404 / ACCESS_TOKEN_INVALID / zero invocations, or a scheduled patrol that reports only new or worse findings" — with comprehensive coverage of the skill's capabilities. The only slight blemish is the "AIOps-style" label, which is more branding than capability, but it does not dilute the concrete action list.

5 / 5

Completeness

Explicitly answers both questions: what it does ("health checks, log diagnosis, alarm interpretation ... fault playbooks ... a scheduled patrol that reports only new or worse findings") and when to use it ("Use when users need ..." plus a dedicated "Triggers on" phrase list). This is the clear-what-plus-concrete-trigger-phrases pattern of the top anchor.

5 / 5

Trigger Term Quality

The "Triggers on 巡检, 诊断, 告警, 峰值 QPS, 限频, 调用量为 0, 定时巡检, 每天检查, 值守, troubleshooting" list covers natural phrases a bilingual user would actually say, including synonyms and register variations (定时巡检 / 每天检查 / 值守 for scheduling; 告警 / 峰值 QPS / 限频 for alert questions). Matches the comprehensive-with-synonyms anchor rather than the good-coverage-with-gaps anchor below it.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — CloudBase inspection/diagnosis with named error codes (429, ACCESS_TOKEN_INVALID, -404005) — and most triggers (巡检, 峰值 QPS, 限频) are unambiguous. However the bare generic trigger "troubleshooting" and "health checks" could overlap with other ops/diagnostic skills in the same plugin family, which keeps it at mostly-distinct rather than minimal-conflict.

4 / 5

Total

19

/

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

TencentCloudBase/CloudBase-AI-Toolkit

Path

plugin/cloudbase/skills/ops-inspector/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.