CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

canary

Post-deploy monitoring: watch production after a deploy and alert on regressions

58

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./examples/skills/canary/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 actionable monitoring skill: executable commands, explicit alert thresholds, transient-tolerance rules, and a decision protocol at each alert. Its main weaknesses are dangling references — the never-defined PAGES array, the never-created latest-snapshot.json, and the undocumented --quick flag — plus mild duplication between the Usage, Two-modes, and Output-format sections.

Suggestions

Define how PAGES is populated from --pages or auto-discovery before the Phase 4 loop uses "${PAGES[@]}".

Either create '.canary/reports/latest-snapshot.json' in Phase 5 or change the Phase 6 baseline-update command to copy from a file the workflow actually produces.

Document the --quick (single-pass) and --duration/--pages handling in Phase 1, or remove them from the Usage examples.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — no explanation of what deploys or HTTP statuses are; commands and templates dominate. Minor trimming is possible: the Usage section repeats the two modes already stated up top, and the 'Output format' section mostly points back to Phase 5 while duplicating the inline alert example, which is why it is not level 5.

4 / 5

Actionability

Mostly executable guidance: concrete curl/jq pipelines, a baseline JSON schema, an alert-condition table with exact thresholds, and copy-paste report templates. Minor gaps keep it below 5: the PAGES array is used in the monitoring loop but never populated, Phase 6 copies '.canary/reports/latest-snapshot.json' which is never created, and the '--quick' flag appears in Usage with no implementing instructions.

4 / 5

Workflow Clarity

A clear six-phase sequence with most checkpoints present: explicit STOP after baseline capture, baseline-diff comparison logic, transient tolerance (alert only on 2+ consecutive checks), and an alert decision menu (A-D) acting as a feedback loop. Not level 5 because argument parsing for --duration/--pages/--quick is only gestured at ('Parse the user's arguments') and the Phase 5-to-6 handoff references a file that no phase writes.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the single-file body is well organized into clearly headed phases with consistent templates. Structure is good with only minor organization gaps (the 'Output format' section redundantly re-references Phase 5 content instead of consolidating), so it sits at level 4 rather than the well-signaled multi-file ideal of level 5 or the inlined-wall-of-text pattern of level 2.

4 / 5

Total

16

/

20

Passed

Description

61%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 concise, domain-specific description with concrete actions, but it lacks any explicit 'Use when...' trigger guidance, which caps its completeness and limits discoverability. Adding trigger phrases (e.g., 'Use after deploying to production or when checking for deploy regressions') would raise both completeness and trigger coverage.

Suggestions

Add an explicit 'when' clause, e.g., 'Use when a deploy has just shipped to production and the user wants to verify nothing broke.'

Include natural trigger synonyms users would actually say: 'canary check', 'smoke test after deploy', 'is production healthy', 'rollout verification'.

Mention the baseline-capture capability ('capture a pre-deploy baseline for comparison') to more fully represent what the skill does.

DimensionReasoningScore

Specificity

The description names the domain ("Post-deploy monitoring") and 1-2 concrete actions ("watch production", "alert on regressions"), matching the level-3 anchor. It is not level 4 because additional concrete capabilities of the skill (baseline capture, health reporting) are not listed.

3 / 5

Completeness

The 'what' is clear (watch production after a deploy, alert on regressions), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. The 'when' is only weakly implied by the phrase "after a deploy".

3 / 5

Trigger Term Quality

Natural terms like "post-deploy", "monitoring", "production", "deploy", and "regressions" give good keyword coverage a user would plausibly say. It falls short of level 5 because common synonyms such as "canary", "smoke test", "rollout", or "health check" are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — post-deploy regression watching is a specific trigger context unlikely to fire for unrelated skills. Minor overlap risk remains with general monitoring, logging, or uptime-checking skills, keeping it below level 5.

4 / 5

Total

14

/

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

FlorianBruniaux/claude-code-ultimate-guide

Path

examples/skills/canary/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.