CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

beacon

Engineering observability and reliability: SLO/SLI design, distributed tracing, alerting, dashboards, capacity planning, toil automation, reliability review. Use for instrumentation or SLO definition.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./beacon/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-structured, highly concrete instruction-only skill body with a clear phased workflow, quantified design parameters, and properly deferred one-level-deep references. Its main cost is redundancy: the same routing information is repeated in five tables plus a duplicative HTML comment block, and version-sensitive details live inline rather than in a dedicated section.

Suggestions

Consolidate the five overlapping routing tables (Workflow, Recipes, Output Routing, Domain Knowledge, Reference Map) into one or two — e.g., keep the Recipes table and the Reference Map, and drop the redundant per-table reference columns.

Remove or heavily trim the CAPABILITIES_SUMMARY HTML comment, which restates the trigger guidance, capability list, and collaboration patterns already covered by body sections.

Move version-pinned details (semconv 1.28/1.40 tracking) into reference/opentelemetry-best-practices.md under a clearly labeled versions section, keeping only a version-agnostic rule inline.

Add failure handling to the VERIFY phase (what to do when alert quality, dashboard readability, or SLO achievability checks fail) to close the feedback-loop gap.

DimensionReasoningScore

Conciseness

The informational content is dense and rule-specific rather than padded with concept explanations, but it could be tightened considerably: the same reference routing is repeated across five overlapping tables (Workflow, Recipes, Output Routing, Domain Knowledge, Reference Map), the CAPABILITIES_SUMMARY HTML comment duplicates body sections wholesale, and version-pinned details ("semconv 1.28+ stable, tracking 1.40+") sit inline rather than in a versioned/deprecated section, which the guidelines penalize.

3 / 5

Actionability

For an instruction-only skill the guidance is unusually concrete and executable as design decisions: exact burn rates ("14.4× over 1h, confirmed over 5min, medium burn 6× over 6h"), quantified error-budget gates ("50% → review; 75% → slow deployments; 90% → freeze; 100% → halt"), specific sampling rates ("keep 100% error/slow traces, sample 10% of successful traces"), and a named scoring formula ("frequency × time-per-occurrence × growth-trajectory × engineering-value"). It falls short of 5 because some directives remain abstract ("Consider alert fatigue in every design", "Design for correlation across signals") and no worked example (e.g., a sample OpenSLO spec) appears inline.

4 / 5

Workflow Clarity

The MEASURE → MODEL → DESIGN → SPECIFY → VERIFY workflow is clearly sequenced in a table with per-phase required actions, key rules, and reference files, and VERIFY is an explicit validation step ("Validate alert quality, dashboard readability, SLO achievability"; "flag uncovered SLIs as blocking gaps in the VERIFY phase"). It is not a 5 because there is no feedback loop — nothing instructs what to do when VERIFY fails, unlike the validate-fix-retry pattern the 5 anchor requires.

4 / 5

Progressive Disclosure

References are one level deep and well signaled — a Reference Map table with per-file "Read this when" guidance, plus targeted pointers like "Detail and sources -> reference/opentelemetry-best-practices.md" — with bulk detail appropriately deferred out of the overview. It is not a 5 because navigation is redundantly spread across five overlapping routing tables (Workflow, Recipes, Output Routing, Domain Knowledge, Reference Map), a minor organization gap.

4 / 5

Total

15

/

20

Passed

Description

75%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 solid, specific description in third-person voice that names the domain and its sub-capabilities with an explicit use-when clause. Its main weaknesses are a trigger clause narrower than the capability list and the absence of common synonyms like "monitoring", "error budget", or "OpenTelemetry" that users would naturally say.

DimensionReasoningScore

Specificity

Lists several specific capabilities — "SLO/SLI design, distributed tracing, alerting, dashboards, capacity planning, toil automation, reliability review" — giving broad coverage of the observability domain. It stops short of a 5 because these are mostly noun phrases rather than concrete action verbs (cf. "Extract text and tables from PDF files, fill forms, merge documents").

4 / 5

Completeness

Both elements are present: the what ("Engineering observability and reliability: SLO/SLI design, distributed tracing, alerting...") and an explicit when ("Use for instrumentation or SLO definition"). The when-clause is narrower than the what — it covers only 2 of the 7 listed capabilities — so it is not a 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "SLO", "SLI", "distributed tracing", "alerting", "dashboards", "capacity planning", "instrumentation" — terms a user with this need would plausibly say. Common variations like "monitoring", "error budget", "OpenTelemetry", and "Grafana" are missing, keeping it below a 5.

4 / 5

Distinctiveness Conflict Risk

The SRE-specific vocabulary (SLO/SLI, burn-rate-adjacent terms, toil automation, capacity planning) carves a clear niche with mostly distinct triggers. Minor overlap risk remains: "Use for instrumentation" could pull implementation requests that belong to coding skills, and "reliability" is a broad term, so it is not a 5.

4 / 5

Total

16

/

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

simota/agent-skills

Path

beacon/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.