ado-pipeline-best-practices — Claude Code skill: setup and features
ado-pipeline-best-practices guides coding agents in designing, auditing, and optimizing Azure DevOps YAML pipelines using enterprise patterns.
MIT 182 installs ★ 66 updated 2026-06-18
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a claude-codeWhat ado-pipeline-best-practices does
This skill gives agents structured procedures for writing and evaluating Azure DevOps pipelines. It enforces separating stages across build, test, and release environments, extracting reusable jobs into templates, and pinning major task versions. Included resources cover matrix builds, dependency caching recipes with Cache@2 for tools like npm, pip, NuGet, and Maven, plus deployment strategies such as rolling, canary, and blue-green.
Security remains central to the workflow. The skill mandates passing credentials exclusively through service connections, variable groups, or Azure Key Vault rather than inline variables. Hardcoded secrets fail its review criteria immediately.
What it helps with
- structure multi-stage Azure DevOps pipelines with approval gates
- configure dependency caching with Cache@2 to speed up builds
- refactor repeated YAML jobs into reusable pipeline templates
- audit CI/CD configurations to eliminate plaintext secrets and inline credentials
Example prompts for the agent
- Review my azure-pipelines.yml file against Azure DevOps best practices
- Help me split this monolithic pipeline into Build, Test, and Deploy stages with environments
- Add npm dependency caching to my pipeline using the Cache@2 task
How to install ado-pipeline-best-practices
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a claude-code2Manually: put the files in place
~/.claude/skills/ado-pipeline-best-practices/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ado-pipeline-best-practices/
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a codex2Manually: put the files in place
.agents/skills/ado-pipeline-best-practices/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a cursor2Manually: put the files in place
.cursor/skills/ado-pipeline-best-practices/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/ado-master/skills/ado-pipeline-best-practices2Manually: put the files in place
.github/skills/ado-pipeline-best-practices/SKILL.md1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a gemini-cli2Platform CLI
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/ado-master/skills/ado-pipeline-best-practicesManually: put the files in place
.devin/skills/ado-pipeline-best-practices/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ado-pipeline-best-practices
How to install ado-pipeline-best-practices in Claude Code?
Run npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a claude-code in your terminal. The file installs to ~/.claude/skills/ado-pipeline-best-practices/SKILL.md.
What does ado-pipeline-best-practices do?
It equips the assistant with checklists, templates, and patterns for Azure Pipelines YAML, covering triggers, template design, caching, matrix jobs, and secret management.
Which deployment strategies are included?
The skill provides guidelines and templates for rolling, blue-green, and canary release strategies paired with environment checks.
Source text
SKILL.md · MIT
---
name: ado-pipeline-best-practices
description: |
Azure DevOps pipeline best practices, patterns, and industry standards.
PROACTIVELY activate for: (1) authoring or reviewing Azure DevOps YAML pipelines, (2) multi-stage pipeline patterns (build, test, deploy), (3) reusable templates (steps, jobs, stages), (4) pipeline caching (Cache@2 task), (5) parallel jobs and matrix strategies, (6) deployment strategies (rolling, blue-green, canary), (7) approvals and environments, (8) variable groups, secret variables, Key Vault linkage, (9) service connections (Azure RM, GitHub, container registries), (10) pipeline versioning and pinning task major versions.
Provides: YAML pattern catalog, template library structure, caching recipes, deployment strategy templates, and a pipeline-quality checklist.
---
# Azure Pipelines Best Practices
Comprehensive best practices for creating and maintaining Azure DevOps YAML pipelines.
## Core Review Procedure
1. Identify trigger scope, deployment environments, and required approvals before editing YAML.
2. Verify secrets flow through service connections, Key Vault, secret variables, or secure files; never inline credentials.
3. Pin task major versions and centralize repeated steps in templates.
4. Add path filters, caching, and parallel jobs only when they reduce real build cost without hiding validation.
5. Keep build, test, package, and deploy concerns separated by stages or jobs.
6. Validate with Azure DevOps pipeline YAML validation or a dry run before recommending rollout.
## Pipeline Structure
**Multi-Stage Pipelines:**
```yaml
# Recommended structure
stages:
- stage: Build
- stage: Test
- stage: DeployDev
- stage: DeployStaging
- stage: DeployProduction
```
**Benefits:**
- Clear separation of concerns
- Conditional stage execution
- Environment-specific configurations
- Approval gates between stages
## Triggers and Scheduling
**Best practices:**
- Use path filters to avoid unnecessary builds
- Enable batch builds for high-frequency repos
- Use PR triggers for validation
- Schedule nightly/weekly builds for comprehensive testing
```yaml
trigger:
batch: true
branches:
include: [main, develop]
paths:
exclude: ['docs/*', '**.md']
pr:
autoCancel: true
branches:
include: [main]
schedules:
- cron: '0 0 * * *'
displayName: 'Nightly build'
branches:
include: [main]
always: false # Only if code changed
```
## Variable Management
**Hierarchy:**
1. Pipeline-level variables (az devops YAML)
2. Variable groups (shared across pipelines)
3. Azure Key Vault (secrets)
4. Runtime parameters (user input)
**Security:**
- Never hardcode secrets
- Use Key Vault for sensitive data
- Mark secrets in variable groups
- Secrets are automatically masked in logs
## Caching
Implement caching for:
- Package dependencies (npm, pip, NuGet, Maven)
- Docker layers
- Build outputs
**Impact:**
- Faster builds (up to 90% reduction)
- Reduced network usage
- Lower costs
## Templates
**Use templates for:**
- Reusable build patterns
- Standardized deployment steps
- Consistent security scanning
- Company-wide best practices
**Benefits:**
- DRY (Don't Repeat Yourself)
- Centralized updates
- Consistent processes
## Security Practices
**Essential:**
- Code scanning (SAST, dependency)
- Container image scanning
- Secret scanning
- Compliance checks
- Branch protection policies
- Required approvals
## Performance
**Optimize:**
- Parallelize independent jobs
- Use caching extensively
- Shallow git clones (fetchDepth: 1)
- Appropriate agent pools
- Clean up artifacts
## Monitoring
**Track:**
- Build success rates
- Build durations
- Test pass rates
- Deployment frequency
- Mean time to recovery (MTTR)
## References and Pairings
- Use Microsoft Azure Pipelines YAML schema documentation for task syntax and newly released features.
- Pair with workload-identity/OIDC guidance when replacing service principal secrets.
- Pair with security scanning guidance when adding SAST, dependency, container, or IaC checks.
Always verify best practices against latest Azure DevOps documentation.
© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace