CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ops-inspector

AIOps-style CloudBase inspection skill (v3). Use when users need health checks, log diagnosis, alarm interpretation (CPU alert normal?, peak QPS), metrics via queryEnv(action=metrics), or fault playbooks for 429 / AI model 429 / function timeout / function 404 / ACCESS_TOKEN_INVALID / zero invocations. 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

85%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 operational skill body: fully executable tool calls, well-sequenced workflows with real validation checkpoints and error-recovery branches, and a clean split of detailed baselines/playbooks into verified one-level-deep references. The main cost is token efficiency — a generic methodology section and heavy repetition of the playbook symptom list and credential gotcha could be trimmed without losing any operational value.

Suggestions

Remove the 'AIOps Methodology' section: its five abstract points (data collection, pattern recognition, baseline comparison, root-cause hypothesis, recommendations) restate diagnostic practice Claude already knows and are already embodied concretely in the workflow steps.

State the v3 fault-playbook symptom list once (in the Activation Contract) and elsewhere refer to 'the matching playbook in references/fault-playbooks.md' instead of repeating the full 429 / AI model 429 / function timeout / function 404 / ACCESS_TOKEN_INVALID / 调用量为 0 enumeration ~6 times.

Deduplicate the per-directory credential-resolution explanation (currently given at lines 39, 51, and 60) into a single mention, and normalize the sibling reference on line 210 to the `../cloudrun-development/references/vpc-and-database.md` path form used everywhere else.

DimensionReasoningScore

Conciseness

The body is mostly dense operational content, but the 'AIOps Methodology' section explains generic diagnostic practice Claude already knows ('Pattern Recognition: Identify recurring errors…'), the full playbook symptom enumeration ('429 / AI model 429 / function timeout / function 404 / ACCESS_TOKEN_INVALID / 调用量为 0') is repeated ~6 times, and the per-directory credential gotcha is explained three times (lines 39, 51, 60). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than the 4 anchor's 'minor instances of over-explanation'.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: exact MCP calls with parameters (e.g. `queryEnv(action="metrics", envId="<EnvId>", metricName="GatewayTraceEnvQPS")`), a 15-row Preferred Tool Map, an 11-row CLS queryString pattern table, console URL templates, an ISO time-format rule, and a complete report skeleton. This matches the 5 anchor ('specific examples cover the common cases') and exceeds the 4 anchor.

5 / 5

Workflow Clarity

The Full Inspection Workflow is a clearly sequenced 7-step process with explicit validation checkpoints (env bind check at Step 1 before anything else; `checkLogService` at Step 3 before log aggregation in Step 6), error-recovery branches (CLS disabled → warning + console link; AI-model 429 → Playbook 5 not Playbook 1; DB connection failures → VpcConf check), and a checkbox minimal checklist — matching the 5 anchor's 'explicit validation steps; feedback loops; checklists'. It is read-only diagnostics, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

Heavy detail is correctly split into two real, one-level-deep reference files (`references/alarm-interpretation.md`, `references/fault-playbooks.md` — both verified to exist) that are clearly signaled with purpose in multiple places ('Alarm interpretation baselines -> references/alarm-interpretation.md', 'Read references/alarm-interpretation.md before concluding'), while the body keeps orchestration, tool maps, and query patterns. One small flaw — line 210 writes `cloudrun-development/references/vpc-and-database.md` without the `../` prefix used for every other sibling path — is a formatting slip, not a structural gap, so the 5 anchor still fits better than the 4 anchor's 'minor organization gaps'.

5 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: concrete capabilities with exact tool actions and error codes, an explicit 'Use when' clause plus a dedicated trigger-term list in both English and Chinese, and a tightly scoped diagnostic niche. The only nit is the mildly buzzwordy "AIOps-style" label and the "(v3)" version tag, which cost tokens without adding trigger value.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "health checks, log diagnosis, alarm interpretation (CPU alert normal?, peak QPS), metrics via queryEnv(action=metrics), or fault playbooks for 429 / AI model 429 / function timeout / function 404 / ACCESS_TOKEN_INVALID / zero invocations" — including the exact tool call and specific error codes. Coverage is comprehensive with no gaps, matching the 5 anchor rather than the 4 ('minor gaps in coverage').

5 / 5

Completeness

It explicitly answers 'what' (inspection, log diagnosis, alarm interpretation, metrics, fault playbooks) and 'when' ("Use when users need…" plus an explicit "Triggers on…" list with concrete phrases), matching the 5 anchor. The 4 anchor would require the 'when' to be less explicit, which is not the case.

5 / 5

Trigger Term Quality

"Triggers on 巡检, 诊断, 告警, 峰值 QPS, 限频, 调用量为 0, troubleshooting" plus natural in-line phrases ("CPU alert normal?", "peak QPS", "timeout") provides comprehensive natural-term coverage including bilingual synonyms. Nothing significant is missing, so it exceeds the 4 anchor ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

The niche is clearly bounded — CloudBase point-in-time diagnostics with distinct triggers (fault codes like ACCESS_TOKEN_INVALID, 告警解读, 峰值 QPS) — giving minimal conflict risk with sibling implementation skills. It is more distinct than the 4 anchor ('minor overlap risk with closely related skills').

5 / 5

Total

20

/

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.