CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deployment-pipeline-design

Architecture patterns for multi-stage CI/CD pipelines with approval gates and deployment strategies.

Quality

67%

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 ./skills/deployment-pipeline-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 delivers concrete, largely executable examples across pipeline stages, approval gates, deployment strategies, and rollback, with real validation/feedback loops in the rollback workflow. However, it is padded with generic filler sections and redundant multi-platform boilerplate, and its progressive disclosure is broken: all referenced bundle files are missing from the skill directory.

Suggestions

Create the referenced bundle files (references/pipeline-orchestration.md, assets/approval-gate-template.yml) or remove the dead references, and standardize on one directory name ("resources/" vs "references/").

Move the per-platform approval-gate and deployment-strategy examples into separate reference files, keeping SKILL.md as a concise overview with one canonical pipeline example.

Delete the generic filler sections ("Instructions", "Do not use this skill when", "Purpose") whose bullets add no domain-specific guidance, and fill in placeholder steps ("# Deployment commands", "deploy.sh production") with real commands.

DimensionReasoningScore

Conciseness

The core technical content (stage breakdown, strategies, rollback) is mostly efficient, but the generic filler sections — "Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes", the trivially generic "Do not use this skill when" bullets, the repeated description line, and full boilerplate YAML for four different CI platforms covering patterns Claude already knows — pad the document noticeably. It sits between anchor 2 (several unnecessary padded sections) and anchor 3 (some unnecessary explanation); the filler is real but interleaved with genuinely useful reference material.

3 / 5

Actionability

Concrete, mostly executable YAML/bash/Python examples cover the common cases: a complete GitHub Actions production pipeline, GitLab delayed approval, Azure ManualValidation, kubectl rollback commands, Argo canary steps, and an automated rollback health-check loop. Minor gaps keep it below anchor 5: placeholders like "# Deployment commands" in the production deploy step and the undefined "deploy.sh production" script.

4 / 5

Workflow Clarity

The "Detailed Stage Breakdown" gives a clear 9-step sequence, and the rollback section provides a genuine feedback loop (deploy → wait for rollout → health check with retry → rollback on failure). It is not anchor 5 because the main pipeline-design guidance lacks an explicit step-by-step workflow with validation checkpoints — much of the body is reference material rather than a sequenced process — but checkpoints are present in the key risky sections, placing it above anchor 3.

4 / 5

Progressive Disclosure

The ~365-line body inlines large multi-platform example sets that clearly belong in separate reference files, and all three referenced paths — `resources/implementation-playbook.md`, `references/pipeline-orchestration.md`, and `assets/approval-gate-template.yml` — point to files that do not exist in the bundle (no references/, scripts/, or assets/ directories are present), with inconsistent directory naming ("resources/" vs "references/"). This matches anchor 2: content that belongs in separate files is inlined, and the references that exist are broken. It does not reach anchor 3 because the reference structure is not merely imperfect — it is nonfunctional.

2 / 5

Total

13

/

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.

The description is domain-specific and reasonably clear about the 'what', with natural trigger terms around CI/CD pipelines, approval gates, and deployment strategies. Its main gaps are the total absence of a 'Use when...' trigger clause and the lack of action verbs naming concrete capabilities.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when designing CI/CD pipelines, configuring deployment approval gates, or choosing deployment strategies (canary, blue-green, rolling).'

Convert the noun phrase into concrete actions, e.g., 'Designs multi-stage CI/CD pipelines, implements approval gates, and selects deployment strategies.'

Include common synonyms and tool names users would naturally say (continuous integration/deployment, release pipeline, GitHub Actions, GitLab CI, Argo Rollouts) to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("multi-stage CI/CD pipelines") plus two concrete topics ("approval gates", "deployment strategies"), but contains no action verbs at all — it is a noun phrase, not a list of concrete actions. It fits anchor 3 (domain plus 1-2 concrete elements, not comprehensive) better than anchor 2 because the named sub-areas are specific rather than generic, and better than anchor 4 because no specific capabilities/actions are enumerated.

3 / 5

Completeness

The 'what' is clear ("Architecture patterns for multi-stage CI/CD pipelines..."), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. This matches anchor 3 exactly; it is not anchor 2 because the 'what' is concrete, and not anchor 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"multi-stage CI/CD pipelines", "approval gates", and "deployment strategies" are natural phrases users would say when needing this skill. It falls short of anchor 5 because synonyms and tool-specific terms users commonly use ("continuous integration", "continuous deployment", "release process", "GitHub Actions/GitLab CI") are missing, but it is well above anchor 3's generic coverage.

4 / 5

Distinctiveness Conflict Risk

"multi-stage CI/CD pipelines with approval gates" carves out a fairly distinct niche with distinguishable triggers. Minor overlap risk remains with closely related skills (e.g., GitHub Actions or GitLab CI implementation skills, which the body itself lists as related), matching anchor 4 rather than anchor 5.

4 / 5

Total

14

/

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

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/deployment-pipeline-design/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.