CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

measure-before-you-fix

Before fixing a slow/stale/timeout alert, measure the step yourself. Kill the theory with a stopwatch, not a code change. Measure-first ops triage for temporal alerts (stale, timeout, freshness, wedged, N hours behind) from gbrain doctor, autopilot, sync, and cron monitors — runs BEFORE any timeout raise, threshold change, or pipeline rewrite.

Quality

92%

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.

The body is an excellent, highly actionable measure-first procedure: executable commands at every step, explicit validation checkpoints, error-recovery guidance, a sharp output template, and well-signaled dedup boundaries against sibling skills. Its only weaknesses are repetition of the 'needs more time vs wedged' distinction and an inlined ~20-line incident anecdote, which keep conciseness and progressive disclosure at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no explaining of concepts Claude already knows — with every section carrying distinct content (e.g. the act-line vs alert-line rule, the red-flags checklist). However, the "needs more time" vs "is wedged — they have opposite fixes" distinction is repeated roughly four times (Contract, threshold-mismatch section, Anti-Patterns, Output Format), and the ~20-line incident anecdote in "Known failure modes handled" could be trimmed, fitting the 'efficient; minor instances of over-explanation that could be trimmed' anchor rather than the lean 5.

4 / 5

Actionability

Fully executable guidance throughout: `time gbrain sync --source source-a --no-embed`, `gbrain sources status`, `grep -n "timeoutMs\|timeout:" <the wrapper or cron script>`, `gbrain jobs list`, named env vars (GBRAIN_SYNC_FRESHNESS_WARN_HOURS / GBRAIN_SYNC_FRESHNESS_FAIL_HOURS), a copy-paste ACT_HOURS/ALERT_HOURS code snippet, and a fill-in measurement-verdict output template. Specific examples cover the common cases.

5 / 5

Workflow Clarity

A 5-step numbered Procedure with explicit validation checkpoints (read the alert's own numbers, compare measured vs budgeted, check the alert threshold against gbrain doctor's authoritative warn/fail lines), a red-flags checklist, and explicit error-recovery feedback ("fix it and re-measure instead of raising timeouts"; the "When it fails" section). The skill is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so all content lives in a well-sectioned single file with clearly signaled, one-level-deep cross-references to sibling skills and conventions (Dedup section gives explicit boundaries for investigate, maintain, smoke-test, cron-scheduler). At ~185 lines with the incident case-study inlined, it exceeds the <50-line simple-skill exception, so it fits 'good structure; most content appropriately placed; minor organization gaps' rather than the ideal split.

4 / 5

Total

18

/

20

Passed

Description

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

The description is highly specific and complete: it names the exact action (measure before fixing), the alert class with natural trigger synonyms, the emitting surfaces, and an explicit use-condition (before any timeout raise, threshold change, or pipeline rewrite). Its only flaw is the second-person imperative voice ("measure the step yourself"), which costs it the top specificity score under the rubric's voice rule.

DimensionReasoningScore

Specificity

Quotes: "measure the step yourself", "Kill the theory with a stopwatch, not a code change", "Measure-first ops triage for temporal alerts ... from gbrain doctor, autopilot, sync, and cron monitors" — multiple concrete actions with named surfaces, matching the comprehensive anchor. However, the imperative second-person voice ("measure the step yourself") incurs the rubric's -1 specificity penalty, so 5 drops to 4.

4 / 5

Completeness

What: "measure the step yourself ... Measure-first ops triage for temporal alerts". When: "Before fixing a slow/stale/timeout alert ... runs BEFORE any timeout raise, threshold change, or pipeline rewrite" — an explicit when-equivalent with concrete trigger phrases, so the missing-'Use when' cap does not apply. Both what and when are answered clearly and explicitly.

5 / 5

Trigger Term Quality

Quotes: "slow/stale/timeout alert", "stale, timeout, freshness, wedged, N hours behind", "sync", "cron monitors" — comprehensive natural terms including synonyms users would actually say when paging about temporal alerts. No common variation is missing for this alert class.

5 / 5

Distinctiveness Conflict Risk

Quotes: "temporal alerts (stale, timeout, freshness, wedged, N hours behind) from gbrain doctor, autopilot, sync, and cron monitors" — a clear niche with distinct trigger terms tied to a specific tool ecosystem, so overlap with other skills is minimal.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

plugin-variants/gbrain-coding/skills/measure-before-you-fix/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.