CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deployment-procedures

Production deployment principles and decision-making. Safe deployment workflows, rollback strategies, and verification. Teaches thinking, not scripts.

Quality

57%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/deployment-procedures/SKILL.md

The canonical home for this skill is deployment-procedures in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

48%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 well-organized with a clear phased workflow and explicit verification/rollback checkpoints, but most of its content restates generic deployment knowledge Claude already has, and guidance remains at the principle level with few concrete commands. At ~240 lines with no reference files, material that belongs in separate references is inlined.

Suggestions

Trim or cut sections that restate common knowledge (zero-downtime strategy definitions, platform capability tables, generic best practices like 'don't deploy on Friday') and keep only genuinely non-obvious guidance.

Move per-platform deployment/rollback tables and zero-downtime strategy details into reference files (e.g. references/platforms.md, references/zero-downtime.md) linked from a lean overview.

Add concrete executable anchors to the workflow phases, e.g. actual health-check commands, log inspection commands, and specific rollback commands per platform, so the VERIFY and ROLLBACK phases are actionable rather than aspirational.

DimensionReasoningScore

Conciseness

Nearly the entire body restates knowledge Claude already has: rolling/blue-green/canary definitions, platform capabilities ('Vercel/Netlify | Git push, auto-deploy'), 'kubectl rollout undo', and common-sense best practices ('Trust but verify', 'Deploy on Friday → Deploy early in week'). Fits 'noticeably verbose; several unnecessary explanations'; not 1 because it is tightly tabular with no padded prose, not 3 because almost no content adds knowledge beyond general deployment wisdom.

2 / 5

Actionability

Concrete anchors exist (rollback methods per platform, verification timings 'First 5 minutes / 15 minutes / 1 hour', 'Performance >50% degraded' threshold), but the core workflows stop at principle level ('Verify code, build, env vars', 'Watch it happen, don't walk away') with no executable commands or specific steps for the deploy/verify phases. Fits 'some concrete guidance but incomplete'.

3 / 5

Workflow Clarity

The 5-phase process (PREPARE/BACKUP/DEPLOY/VERIFY/CONFIRM-or-ROLLBACK) is clearly sequenced with explicit checkpoints: a pre-deployment checklist, a verification window, and a rollback symptom→action table, so validation is present for this risky operation. Fits 'clear sequence with most checkpoints present; minor validation gaps'; not 5 because there are no error-recovery feedback loops within phases and checkpoints lack concrete commands, not 3 because checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

The file is well-sectioned with clear headers, but at ~240 lines it far exceeds overview size, and reference-shaped material (per-platform deployment/rollback tables, zero-downtime strategy details, emergency procedures) is fully inlined with no offloading to reference files — none exist in the bundle. Fits 'some structure but content that should be separate is inline'; not 2 because in-file structure is clean, not 4 because nothing is split out.

3 / 5

Total

12

/

20

Passed

Description

50%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 communicates the domain and intent clearly, but has no explicit 'Use when...' trigger clause and relies on generic noun phrases rather than concrete capabilities. Trigger keywords are relevant but miss common synonyms like 'release' or 'go-live'.

Suggestions

Add an explicit trigger clause, e.g. 'Use when deploying to production, releasing changes, or when the user mentions deployment, releases, rollback, or go-live.'

Replace abstract noun phrases ('principles and decision-making') with concrete capabilities like 'choose deployment strategy, run pre-deployment checks, verify releases, and execute rollbacks'.

Include natural synonyms users actually say (release, ship, go-live, zero-downtime, CI/CD) to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

Names the domain and a few activity areas ('Safe deployment workflows, rollback strategies, and verification'), but these are generic noun phrases rather than concrete actions and coverage is partial (no monitoring, zero-downtime, or emergency handling mentioned). Fits 'names domain and 1-2 concrete actions, but not comprehensive'; not 4 because the actions are abstract, not 2 because several concrete activity areas are listed.

3 / 5

Completeness

The 'what' is clear (deployment principles, workflows, rollback, verification) but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. 'Teaches thinking, not scripts' describes style, not when to invoke the skill.

3 / 5

Trigger Term Quality

'Production deployment' and 'rollback strategies' are natural user phrases, but common variations users would say — 'release', 'ship', 'go-live', 'zero-downtime', 'deploy to production' — are missing. Fits 'some relevant keywords but missing common variations or synonyms'; not 4 because key synonyms are absent, not 2 because more than one relevant natural keyword is present.

3 / 5

Distinctiveness Conflict Risk

The deployment/rollback niche is identifiable, but 'Production deployment principles and decision-making' is broad framing that could overlap with CI/CD pipeline, release-management, or per-platform deployment skills. Fits 'somewhat specific but could still overlap with similar skills'; not 4 because no distinct trigger phrases carve out a clear niche.

3 / 5

Total

12

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/deployment-procedures/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.