CtrlK
BlogDocsLog inGet started
Tessl Logo

package

Rebuild the SkyWalking distribution and OAP Docker image after source changes. Use before running e2e tests so the image reflects your code changes. Avoids the "image looks updated but runtime has stale jars" trap.

69

Quality

85%

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

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.

Excellent actionable content: every path through the decision tree ends in an executable command, and the verify-the-jar loop is a genuine validation checkpoint with error recovery. Weaknesses are minor — some repetition of the same commands and rationale across sections, and no use of reference files to slim the main body.

DimensionReasoningScore

Conciseness

Nearly every section conveys non-obvious, project-specific knowledge Claude cannot infer (make prerequisite behavior, flatten-maven pitfalls, buildx stalls) with no filler explanation of known concepts. It falls short of the top anchor only through mild repetition — the fast mvn command and 'do not skip flatten:flatten' guidance each appear three times ('Pick the right command', 'Common pitfalls', 'The golden rule').

4 / 5

Actionability

Every scenario has a copy-paste-ready command (e.g., './mvnw -pl apm-dist -am -o clean flatten:flatten package -Pbackend,dist -DskipTests -Dcheckstyle.skip=true -Dmaven.javadoc.skip=true'), and the verification procedure is fully concrete ('docker cp <container>:/skywalking/oap-libs/... /tmp/verify.jar', 'jar -xf', 'grep -oa'). Placeholders like <module>-<version>.jar are inherent parameters rather than pseudocode, matching the 'fully executable, covers common cases' anchor.

5 / 5

Workflow Clarity

The workflow is a clear decision tree by change type (OAP source, dist packaging only, Dockerfile only), followed by an explicit validation checkpoint ('Verify the fix reached the image') and a feedback loop ('If grep finds nothing... Re-run with the correct chain'), plus recovery guidance for failure modes (half-built dist, stalled buildx). This matches the top anchor: explicit validation steps with error-recovery loops.

5 / 5

Progressive Disclosure

A single self-contained file with well-labeled sections, a summary table, and no nested or dead references — good structure with minor organization gaps. It is not the top anchor because at ~107 lines, with no bundle files provided, sections like the rationale for make's dependency behavior and the 'Common pitfalls' list could be split into a reference file to keep SKILL.md as a leaner overview.

4 / 5

Total

18

/

20

Passed

Description

82%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: explicit what and when with concrete, natural trigger terms tied to a distinct niche. The only gap is breadth of capability coverage — it names two rebuild actions but omits supporting actions like picking the right build chain or verifying the fix landed in the image.

Suggestions

Add one more concrete capability to round out coverage, e.g. 'Verify the fix actually reached the image's jars before running e2e', which is the skill's core value proposition.

Include a couple of synonymous trigger terms users might say, such as 'tarball', 'package the dist', or 'docker build' alongside 'rebuild'.

DimensionReasoningScore

Specificity

Names the domain ('SkyWalking distribution and OAP Docker image') with exactly two concrete actions — rebuild the dist and rebuild the image — matching the anchor for 'domain and 1-2 concrete actions, not comprehensive'; it does not list several actions (e.g., verification, picking the right build chain) needed for a higher score.

3 / 5

Completeness

Explicitly answers both: what ('Rebuild the SkyWalking distribution and OAP Docker image after source changes') and when ('Use before running e2e tests so the image reflects your code changes') with a concrete trigger phrase. The 'when' clause is explicit and specific, matching the top anchor rather than the 'could be more explicit' level 4.

5 / 5

Trigger Term Quality

Contains natural phrases users would say when needing this skill — 'rebuild', 'Docker image', 'e2e tests', 'source changes', 'stale jars', 'OAP' — but misses a few common synonyms like 'tarball', 'package', or 'docker build'. Good coverage with a few natural terms missing, so anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a clearly distinct niche (SkyWalking OAP dist/image rebuild) with triggers ('e2e tests', 'stale jars') that no generic build or docker skill would match, giving minimal conflict risk — the top anchor.

5 / 5

Total

17

/

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
apache/skywalking
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.