CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

new-monitoring-feature

Add a new monitoring target / layer to SkyWalking OAP. Orients you to the OAL / MAL / LAL / SpanListener / SegmentListener extension points, the UI template + submodule touchpoints, the docs set that must move together, and the cross-cutting traps that don't live in any one skill.

1.11x
Quality

80%

Does it follow best practices?

Impact

95%

1.11x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/new-monitoring-feature/SKILL.md
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 exemplary wiring-map skill for a complex multi-extension-point system: copy-paste-ready paths, code, and commands; a fully sequenced workflow with strong validation posture; and well-signaled one-level references. The only deductions are repeated trap entries that could be consolidated and large inline tables that could be split into reference files.

DimensionReasoningScore

Conciseness

Nearly every line is repo-specific knowledge Claude would not already know (ordinal conventions, registration paths, histogram rescaling, UI chrome buffer) with no conceptual padding, so it is efficient overall. Not 5 because several items are stated twice — histogram bucket-unit/per-bucket/overflow traps appear in both §3.3 and the §9 table, config-dump drift appears three times (§3.2, §7, §9), and the curl retry pattern and SW_UI_TEMPLATE_FORCE_RELOAD each appear twice — and could be consolidated to references.

4 / 5

Actionability

Fully executable throughout: exact file paths (Layer.java, ui-initialized-templates/<feature>/, layer-extensions.yml), copy-paste SPI interface and catalog-lookup code, yaml registration fragments, and concrete commands (./mvnw flags, curl -sS -f --retry 30 …, SW_UI_TEMPLATE_FORCE_RELOAD=true) covering the common cases per signal type. Nothing is pseudocode.

5 / 5

Workflow Clarity

A clearly ordered end-to-end sequence (§0 register Layer → §1 pick extension point → §2 trace → §3 metrics → §4 logs → §5 UI → §6 docs → §7 e2e → §8 pre-submit checklist run in order) with explicit validation checkpoints and feedback loops: "verify every new feature locally before pushing", per-case hand verification, what javadoc errors vs warnings mean, and "if you find yourself editing more than this skill suggests, stop and confirm".

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so everything lives in SKILL.md, but external details are pushed to clearly-signaled one-level-deep pointers: sibling skills (run-e2e, compile, package, license, gh-pull-request) and repo docs/analyzer CLAUDE.md files, each annotated with what it contains. Not 5 because the very large §9 traps table and §10 reference-extensions catalog are inlined monolithically rather than split into a reference file.

4 / 5

Total

18

/

20

Passed

Description

65%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 domain-specific, well-targeted description that clearly names the niche and its extension points with strong distinctiveness. It loses points for the missing explicit "use when" trigger clause and for second-person phrasing ("Orients you to…") where third person is required.

Suggestions

Add an explicit trigger clause, e.g. "Use when adding a new monitoring target, Layer, or telemetry source (metrics, logs, traces) to SkyWalking OAP".

Rewrite in third-person voice — "Orients you to…" becomes e.g. "Maps the OAL / MAL / LAL / SpanListener / SegmentListener extension points…".

Include the natural terms users would say for the downstream work — dashboards, e2e tests, MAL/LAL rule files — to broaden trigger coverage.

DimensionReasoningScore

Specificity

Enumerates several specific coverage areas ("OAL / MAL / LAL / SpanListener / SegmentListener extension points, the UI template + submodule touchpoints, the docs set that must move together, and the cross-cutting traps"), which would anchor at 4 ("Lists several specific actions; minor gaps"), but "Orients you to…" is second-person voice and the rubric's voice penalty reduces it by 1. Not a 2 because the domain and its objects are named concretely rather than generically.

3 / 5

Completeness

The "what" is clear and multi-part (extension-point orientation, UI touchpoints, docs set, cross-cutting traps), but there is no "Use when…" clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2 because the what-side is far from vague.

3 / 5

Trigger Term Quality

"Add a new monitoring target / layer to SkyWalking OAP" plus OAL / MAL / LAL / SpanListener are exactly the phrases a SkyWalking developer would use, giving good keyword coverage. Not 5 because common natural variations like "dashboard", "metrics", or "e2e test" are absent; not 3 because the included terms go well beyond one or two generic keywords.

4 / 5

Distinctiveness Conflict Risk

"SkyWalking OAP" layer/monitoring-target extension work is a clear niche with distinct, specific trigger terms (OAL, MAL, LAL, SpanListener, SegmentListener) that would not fire adjacent skills like compile/package/run-e2e.

5 / 5

Total

15

/

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

relative_links

Relative link issues: 19 suspicious

Warning

Total

15

/

16

Passed

Repository

apache/skywalking

Path

.claude/skills/new-monitoring-feature/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.