Execute use when you need to work with deployment and CI/CD. This skill provides deployment automation and pipeline orchestration with comprehensive guidance and automation. Trigger with phrases like "deploy application", "create pipeline", or "automate deployment".
48
37%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/devops/ci-cd-pipeline-builder/skills/building-cicd-pipelines/SKILL.mdQuality
Discovery
40%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 relies heavily on vague buzzwords ('comprehensive guidance and automation', 'pipeline orchestration') without specifying concrete actions the skill performs. While it includes some trigger phrases, the lack of specific capabilities makes it hard to distinguish from other DevOps-related skills and provides little information for Claude to make an informed selection.
Suggestions
Replace vague language with specific concrete actions, e.g., 'Generates CI/CD pipeline configurations (GitHub Actions, GitLab CI, Jenkins), creates Dockerfiles, configures deployment scripts, and sets up automated testing stages.'
Expand trigger terms to include common variations like 'CI/CD', 'GitHub Actions', 'Jenkins', 'release pipeline', 'build and deploy', 'continuous integration', '.yml pipeline config'.
Clarify the 'what' by listing 2-4 specific tasks the skill performs rather than using abstract phrases like 'comprehensive guidance and automation'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague, buzzword-heavy language like 'deployment automation and pipeline orchestration with comprehensive guidance and automation.' No concrete actions are listed—it doesn't specify what it actually does (e.g., configure YAML pipelines, push to Docker registries, run tests). | 1 / 3 |
Completeness | It has a 'Use when' clause and trigger phrases, addressing the 'when' aspect. However, the 'what' is extremely vague—'deployment automation and pipeline orchestration with comprehensive guidance' doesn't concretely explain what the skill does, so the 'what' is very weak. | 2 / 3 |
Trigger Term Quality | It includes some relevant trigger phrases like 'deploy application', 'create pipeline', and 'automate deployment', which are natural terms users might say. However, it misses common variations like 'CI/CD', 'GitHub Actions', 'Jenkins', 'release', 'build pipeline', '.yml', etc. | 2 / 3 |
Distinctiveness Conflict Risk | The terms 'deployment' and 'CI/CD' provide some domain specificity, but the description is broad enough that it could overlap with infrastructure-as-code skills, Docker skills, cloud platform skills, or general DevOps skills without clear boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable high-level framework for CI/CD pipeline creation but critically lacks executable code examples—the most important element for a skill about generating configuration files. The content reads more like a tutorial outline than actionable guidance, with abstract instructions like 'Generate the pipeline configuration file' instead of showing actual YAML/Groovy templates. The error handling table is a strength, but the skill would benefit enormously from concrete, copy-paste-ready pipeline snippets.
Suggestions
Add at least one complete, executable GitHub Actions workflow YAML example (and ideally one for GitLab CI) showing the full lint->test->build->deploy pipeline described in the instructions.
Replace the Examples section's prompt descriptions with actual output examples showing what a generated pipeline configuration should look like.
Add explicit validation checkpoints within the workflow steps, e.g., 'After generating the workflow file, validate with `actionlint .github/workflows/ci.yml` before committing. If errors, fix and re-validate.'
Remove the Prerequisites and Resources sections (Claude already knows these) and use the saved tokens for concrete code templates like a multi-stage Dockerfile and a Kubernetes deployment manifest snippet.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary content like the Prerequisites section (Claude knows what Docker and Git are), the Resources section with well-known URLs, and the Examples section which describes prompts rather than providing executable output. The error handling table adds value but the overall content could be tightened. | 2 / 3 |
Actionability | Despite being a CI/CD pipeline skill, there are zero executable code examples—no sample YAML workflow, no Jenkinsfile snippet, no Dockerfile template. The instructions are a high-level checklist of abstract steps ('Generate the pipeline configuration file') rather than concrete, copy-paste-ready configurations. The Examples section lists prompt descriptions rather than actual pipeline code. | 1 / 3 |
Workflow Clarity | The 10-step instruction sequence provides a reasonable ordering of pipeline creation steps, and step 10 mentions syntax validation. However, there are no explicit feedback loops (validate -> fix -> retry), no checkpoints between steps, and the validation step is listed last rather than integrated throughout. For a skill involving deployment (a destructive/risky operation), the lack of rollback verification and validation checkpoints is notable. | 2 / 3 |
Progressive Disclosure | The content is structured with clear section headers and the error handling table is well-organized. However, it's somewhat monolithic—the detailed error table, prerequisites, and resources could be in separate files. The Resources section links to external docs but there are no internal file references for deeper content like example pipeline templates. | 2 / 3 |
Total | 7 / 12 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 — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
3e83543
Table of Contents
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.