CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

canary-deployment

Planeja rollout gradual, observacao e rollback de releases. Trigger em: "canary", "canary deployment", "rollout gradual", "blue-green", "feature flag rollout", "progressive deployment", "gradual release", "rollback automatico", "deploy seguro".

Quality

84%

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

77%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 dense, operational runbook with an exemplary gated workflow: an explicit step ladder, quantified metric thresholds, four rollback triggers, an escalation feedback loop, and a completion checklist. Its weaknesses are structural — everything lives inline in one ~230-line file with no bundle files, and the governance/handoff policy files it cites do not exist in the bundle.

Suggestions

Split the per-strategy deep-dives (traffic-based, feature flag, blue-green) and/or the metrics threshold table into files under references/, keeping SKILL.md as a shorter overview with clearly signaled one-level-deep links.

Ensure referenced files (GLOBAL.md, policies/*.md, memory/constitution.md) actually resolve within the skill bundle, or inline the essential rules — currently no such files ship with the skill, leaving the governance sections dangling.

Provide one complete, runnable example per strategy (e.g. an actual canary-1pct.yaml and concrete target group ARNs) so the code blocks are copy-paste ready rather than placeholder-dependent.

DimensionReasoningScore

Conciseness

Dense operational content with no tutorial padding — it assumes competence and skips explaining what canary deployment or a service mesh is. Not 5: minor over-explanation could be trimmed, e.g. the definitional line "Dois ambientes identicos: blue (atual em producao) e green (nova versao)" and some prose in 'Integracao com Pipeline'; not 3 because these are isolated instances in an otherwise efficient runbook.

4 / 5

Actionability

Concrete guidance throughout: a step ladder with exact percentages and soak times ("Step 2: 10% — soak 30 min"), quantified thresholds ("canary <= stable * 1.20"), and a near-executable AWS ALB command; the pseudocode is explicitly justified ("Pseudocodigo agnostico de stack", stack-flexibility policy). Not 5: placeholders ("...stable...", "TargetGroupArn":"...") and referenced-but-nonexistent files (canary-1pct.yaml) mean nothing is copy-paste ready.

4 / 5

Workflow Clarity

Clear sequence (Step 0→100%) with per-step observation, pre-flight gates ("se baseline nao existe ou error budget esta esgotado, nao iniciar canary"), four explicit rollback triggers with sample persistence (N >= 2), a genuine error-recovery feedback loop ("se nao confirmar dentro da janela, escalar pra on-call humano imediatamente, nao repetir o comando de reversao"), and a completion checklist ('Evidencia de Conclusao'). This is the top anchor's profile: explicit validation, feedback loops, and checklists for a risky production operation.

5 / 5

Progressive Disclosure

Good internal section structure with clearly signaled references, but it is a ~230-line monolith with zero bundle files, and the referenced paths (GLOBAL.md, policies/execution.md, policies/handoffs.md, memory/constitution.md) do not resolve anywhere in the skill bundle. Not 2: sections are well organized and references are explicit, not buried; not 4: no content is split into separate files and the referenced files cannot be verified to exist.

3 / 5

Total

16

/

20

Passed

Description

83%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 cleanly states what the skill does in third person and provides an explicit, synonym-rich trigger clause with nine natural terms. Minor gaps: the action list stays high-level under a single verb, a common variant like 'canary release' is missing, and the generic 'deploy seguro' trigger carries some overlap risk with sibling deploy skills.

DimensionReasoningScore

Specificity

Lists several concrete capabilities — "Planeja rollout gradual, observacao e rollback de releases" names plan, monitor, and revert actions — matching the 'several specific actions; minor gaps' anchor. Not 5: the single verb 'Planeja' keeps actions at a higher level than the top anchor's granular multi-verb list, and body-level capabilities (threshold tuning, postmortem, communication) are absent.

4 / 5

Completeness

Explicitly answers both parts: a clear what ("Planeja rollout gradual, observacao e rollback de releases") and an explicit when-equivalent clause ("Trigger em: 'canary', 'canary deployment', ...") with concrete trigger phrases. Not 4: the when-clause is fully explicit with concrete phrases rather than vague or implicit, matching the top anchor.

5 / 5

Trigger Term Quality

Nine natural trigger terms with good synonym coverage ("rollout gradual", "gradual release", "progressive deployment", "feature flag rollout", "blue-green") that users would plausibly say. Not 5: common variants like "canary release" and "traffic shifting"/"percentage rollout" are missing; not 3 because coverage clearly exceeds 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Clear niche (gradual rollout strategy) with distinct triggers like "canary", "blue-green", and "feature flag rollout". Not 5: the generic "deploy seguro" trigger creates minor overlap risk with the sibling deploy/release-manager skills the body references; not 3 because the core triggers are tightly specific to rollout strategy rather than broadly overlapping.

4 / 5

Total

17

/

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

felvieira/claude-skills-fv

Path

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