Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ado-pipeline-best-practices -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/ado-pipeline-best-practices/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ado-pipeline-best-practices/

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

Similar skills

All skills for DevOps and infrastructure →

From the same set96

The whole set →
ffmpeg-kinetic-captions ffmpeg-kinetic-captions writes ASS subtitles with animated captions: a karaoke highlight that scales each word, pop-in bounces, shake on the beat. Made for vertical video. CX Codex +1 193installs docker-platform-guide docker-platform-guide — a skill that briefs your coding agent on Docker differences between Windows, Linux and macOS, from WSL2 backends to multi-arch builds. CX Codex +1 192installs tsql-functions tsql-functions is a Claude Code skill with a categorized, version-tagged reference for T-SQL functions in SQL Server and Azure SQL Database. It activates when a conversation involves T-SQL functions. CX Codex +1 187installs viral-video-short-form viral-video-short-form is a Claude Code skill for planning short videos on TikTok, Reels, and YouTube Shorts. It activates for work on hooks, captions, and posting strategy. CX Codex +1 186installs parallel-processing-patterns The parallel-processing-patterns skill covers parallel Bash jobs with GNU Parallel, xargs -P, and background processes. Use it to process files concurrently or cap the number of running tasks. CX Codex +1 181installs compose-patterns-2025 The compose-patterns-2025 skill guides Docker Compose setups for multiple environments, service health checks, and network separation. Use it when shaping production Compose files. CX Codex +1 179installs ffmpeg-transitions-effects ffmpeg-transitions-effects is a Claude Code skill for building video transitions with FFmpeg. It activates for clip sequences, slideshows, fades, and synced audio crossfades. CX Codex +1 176installs powershell-2025-changes powershell-2025-changes is a Claude Code skill that lists PowerShell changes in 2025 and replacement cmdlets for scripts affected by them. CX Codex +1 174installs

More in the catalog

Project sponsors

Companies that keep this analytics open