agentleFS
BenknightdarkBenknightdark/neo-skills/skills/neo-azure-pipelines/SKILL.md

neo-azure-pipelines

Skill7 starsChanged 6 months agoMITView on GitHub

Use this skill when the user asks to create, review, debug, or modernize Azure Pipelines YAML for CI/CD, especially .NET builds, Azure App Service deploys, or IIS/on-premises deploys. Prefer bundled templates and verify task syntax against Microsoft docs when version-specific accuracy matters.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 6 are distinctive, and 6 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    When version-specific syntax or task versions matter, verify them against …

    line 17
  2. Distinctive:

    Read security and compliance requirements, including Static Application Security Testing (SAST), package vulnerability scanning, and …

    line 21
  3. Very specific:

    If the project is .NET and needs deployment to IIS, combine build-dotnet.yml and deploy-iis.yml.

    line 36
  4. Very specific:

    If artifact manipulation is required, prioritize using util/extract-artifact.yml.

    line 37
  5. Distinctive:

    When configuring a CI process for a .NET project:

    line 55
  6. Distinctive:

    Check for any existing pipeline configurations.

    line 57
  7. Very specific:

    Create the .pipelines/templates/build/ and .pipelines/templates/util/ directories.

    line 58
  8. Distinctive:

    When configuring a CD process for Azure App Service:

    line 63
  9. Very specific:

    Ensure the YAML correctly configures environment, strategy: runOnce, and template calls.

    line 68
  10. Distinctive:

    When configuring a CD process for on-premises IIS:

    line 72
  11. Distinctive:

    Verify if the project requires specific ASP.NET Core environment settings.

    line 74
  12. Very specific:

    Ensure the script integrates iis-backup.yml and iis-rollback.yml logic.

    line 77

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Azure Pipeline Script Design Specifications

Perceive

  1. When version-specific syntax or task versions matter, verify them against https://learn.microsoft.com/en-us/azure/devops/pipelines/?view=azure-devops; if browsing is unavailable, state the uncertainty and rely on bundled templates plus project evidence.
  2. Identify the application's development language (e.g., .NET, Java, Python, Node.js) and its specific version requirements.
  3. Identify the target deployment platform (e.g., Azure App Service, Azure Kubernetes Service, Function App, or on-premises servers).
  4. Detect the project source code structure to confirm build tools (e.g., Maven, Gradle, Npm, NuGet) and testing frameworks.
  5. Read security and compliance requirements, including Static Application Security Testing (SAST), package vulnerability scanning, and container image scanning.
  6. Confirm environment variable requirements, secret information sources (e.g., Azure Key Vault), and Service Connection permissions.
  7. Proactively scan the skills/neo-azure-pipelines/templates/ directory to identify existing reusable template resources. Includes:
    • Build: build/build-dotnet.yml
    • Deploy: deploy/deploy-app-service.yml, deploy/deploy-iis.yml
    • Utils: util/clean-artifact.yml, util/extract-artifact.yml, util/iis/*.yml, etc.

Reason

  1. Compare documented task versions with existing configurations to determine if task versions need updating (e.g., using Checkout@v1 vs. Checkout@v4).
  2. Determine whether to adopt a multi-stage architecture based on project scale to achieve logical isolation of Build, Test, Staging, and Production.
  3. Evaluate and design build caching strategies, optimizing dependency package folders to reduce execution time.
  4. Design trigger mechanisms based on branching strategies, distinguishing trigger paths for Continuous Integration (CI) and Continuous Deployment (CD).
  5. Determine the applicability of deployment strategies, such as Blue-Green, Canary, or Rolling Update.
  6. Validate conditional execution syntax (Conditions) in Pipeline logic to ensure subsequent steps only execute on specific branches or after successful prerequisites.
  7. Prioritize using templates from skills/neo-azure-pipelines/templates/ to assemble the Pipeline, rather than writing raw YAML from scratch.
    • If the project is .NET and needs deployment to IIS, combine build-dotnet.yml and deploy-iis.yml.
    • If artifact manipulation is required, prioritize using util/extract-artifact.yml.

Act

General Output Standards

  1. Output YAML configuration scripts that comply with the current project-compatible Azure DevOps schema; state assumptions when exact task versions cannot be verified.
  2. Provide comprehensive parameter definitions to increase the flexibility and reusability of Pipeline execution.
  3. Generate configuration recommendations for Environments and Approvals and Checks.
  4. Output a list of Task resource references used in the script, labeling version numbers to ensure execution environment consistency.
  5. Provide preventive comments and explanations for common execution errors (e.g., insufficient permissions, dependency conflicts).
  6. Use template syntax to reference selected template files and correctly pass required parameters. For example:
    - template: skills/neo-azure-pipelines/templates/build/build-dotnet.yml
      parameters:
        buildConfiguration: 'Release'

CI Workflow: .NET Build Pipeline

When configuring a CI process for a .NET project:

  1. Scan the project directory to identify the .NET version (e.g., .NET 8/10/11), project name, and solution file (.sln).
  2. Check for any existing pipeline configurations.
  3. Create the .pipelines/templates/build/ and .pipelines/templates/util/ directories.
  4. Copy build/build-dotnet.yml and util/clean-artifact.yml templates to their respective locations.
  5. Generate azure-pipelines-ci.yml in the project root, ensuring the structure uses proper template syntax with correct parameters.

CD Workflow: Azure App Service Deployment

When configuring a CD process for Azure App Service:

  1. Confirm the Azure App Service name, environment name (e.g., Production/Staging), and Service Connection name with the user or from the project context.
  2. Identify the Build Artifact name.
  3. Copy deploy/deploy-app-service.yml to the project's .pipelines/templates/deploy/ directory.
  4. Generate the deployment pipeline file (e.g., azure-pipelines-cd-appservice.yml) in the project root.
  5. Ensure the YAML correctly configures environment, strategy: runOnce, and template calls.
  6. Advise the user on setting up corresponding Environments and Approvals in Azure DevOps.

CD Workflow: On-Premises IIS Deployment

When configuring a CD process for on-premises IIS:

  1. Confirm IIS parameters: Website Name, Physical Path, Deployment Group name, and target environment.
  2. Verify if the project requires specific ASP.NET Core environment settings.
  3. Copy the entire util/iis/ directory and the deploy/deploy-iis.yml template to the project's .pipelines/templates/ directory.
  4. Generate the deployment script (e.g., azure-pipelines-cd-iis.yml) in the project root, referencing deploy-iis.yml with parameters like websiteName and physicalPath.
  5. Ensure the script integrates iis-backup.yml and iis-rollback.yml logic.
  6. Explain the requirements for Service Connection permissions and Deployment Group configuration.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.