CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

signals-scout-insight-alerts

Signals scout over the project's configured insight alerts. Reads each alert's recent firing history and surfaces the firings a human likely missed.

60

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./products/signals/skills/signals-scout-insight-alerts/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.

The body is a tight, highly actionable triage workflow with explicit tool calls, a decision matrix, validation checkpoints, and feedback loops; it does not pad with concepts Claude already knows. Main improvement is reducing cross-section repetition and pulling the report-contract reference under this skill's own bundle for cleaner navigation.

DimensionReasoningScore

Conciseness

The body is dense with high-signal operational detail Claude would not know (exact tool params, scratchpad key prefixes, the discriminator) and avoids explaining concepts Claude already knows. It is not a 5 because the discriminator and edit-vs-author rules are restated across sections and could be tightened, and not a 3 because padding is minor rather than pervasive.

4 / 5

Actionability

Guidance is fully executable: exact tool calls with parameters (e.g., 'alert-get checks_date_from=-24h', 'scout-scratchpad-search text=insight_alerts limit=100'), concrete scratchpad key templates, named fields, a decision matrix, and P1/P2/P3 priorities. Per the scoring notes, absence of literal code is not penalized for an instruction-only skill when guidance is this actionable; it is not a 4 because the common cases are covered copy-paste ready.

5 / 5

Workflow Clarity

A clear sequenced workflow (Get oriented → Narrow to candidates → Deep-read → Save memory → Decide → Close out) with explicit validation checkpoints (inbox/dedupe check before authoring, 'when in doubt refresh memory', close-out summary, cap disclosure) and feedback loops (edit with append_evidence instead of duplicating). Because validation is present, the batch-operation cap does not apply; it is not a 4 because checkpoints and checklists (Disqualifiers, When to stop) are explicit rather than implicit.

5 / 5

Progressive Disclosure

Content is well-structured with clear section headers and defers the bulky generic report-channel contract to a one-level-deep signaled reference ('authoring-scouts → references/report-contract.md'), keeping only insight-alerts-specific framing inline. It is not a 5 because no local bundle files exist and the referenced contract lives under a sibling skill rather than this skill's own references, making navigation slightly indirect, and not a 3 because structure and signaling are clearly good.

4 / 5

Total

18

/

20

Passed

Description

53%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 specific and distinct, clearly conveying what the scout does, but it omits any explicit trigger/usage guidance and has only modest natural keyword coverage. Adding a 'Use when...' clause with user-facing synonyms would lift the completeness and trigger_term_quality dimensions.

Suggestions

Add an explicit 'Use when...' clause naming the situations a user would invoke this for (e.g., daily missed-insight-alert triage).

Include natural synonyms users actually say alongside 'insight alerts' (e.g., 'threshold alerts', 'anomaly alerts', 'alert firings').

Name one or two more concrete actions to round out coverage (e.g., 'suppresses noise', 'files a report per missed firing').

DimensionReasoningScore

Specificity

Names the domain ('configured insight alerts') and two concrete actions ('Reads each alert's recent firing history', 'surfaces the firings a human likely missed'), but coverage is not comprehensive. It is not a 4 because only two actions are listed with minor gaps, and not a 2 because the actions are concrete rather than generic.

3 / 5

Completeness

It clearly states what the skill does (reads firing history, surfaces missed firings) but gives no 'when should Claude use it' trigger guidance; per the rubric a missing 'Use when...' clause caps completeness at 3. It is not a 4 because there is no explicit 'when' at all, and not a 2 because the 'what' is clear rather than vague.

3 / 5

Trigger Term Quality

'insight alerts' and 'firing history' are relevant domain terms a user might say, but common variations/synonyms and a natural 'Use when...' phrasing are missing. It is not a 4 because keyword coverage is thin and not a 2 because the terms present are genuinely relevant rather than purely generic.

3 / 5

Distinctiveness Conflict Risk

The framing ('configured insight alerts', 'firings a human likely missed') carves a clear niche with distinct triggers. It is not a 5 because closely related sibling scouts (anomaly-detection, observability-gaps) create minor overlap risk, and not a 3 because the niche is specific rather than broadly overlapping.

4 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

PostHog/posthog

Path

products/signals/skills/signals-scout-insight-alerts/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.