sampler-framework

Coordinate scaffolding, builds, tests, versioning, and CI/CD for PowerShell modules with Sampler.

11|1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/raandree/CopilotAtelier --skill sampler-framework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sampler-framework
Source: https://github.com/raandree/CopilotAtelier/tree/main/Skills/sampler-framework
Command: npx skills add https://github.com/raandree/CopilotAtelier --skill sampler-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines scaffolding, building, testing, versioning, and CI/CD for PowerShell module projects using the Sampler framework. It provides a unified reference for project structure, build.yaml configuration, dependency management, and reusable workflows.

Core Features & Use Cases

  • Scaffold and coordinate multi-module PS projects with a standardized structure and end-to-end build pipelines.
  • Automate build, test, versioning, packaging, and CI/CD across Windows, macOS, and Linux using Sampler components such as ModuleBuilder, Invoke-Build, Pester, GitVersion, Plaster, and ChangelogManagement.
  • Streamline releases and changelogs across GitHub Actions and Azure Pipelines with consistent artifacts and documentation.

Quick Start

Install the Sampler package and initialize the default build workflow to bootstrap and build your module.

Frequently Asked Questions about sampler-framework

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate PowerShell module builds across Windows, macOS, and Linux?

Automate PowerShell module builds across Windows, macOS, and Linux by orchestrating a unified pipeline with Sampler. It coordinates InvokeBuild, ModuleBuilder, and Pester to standardize multi-module project workflows and ensure reproducible releases.

What is the best way to scaffold a multi-module PowerShell repository?

Scaffolding a multi-module PowerShell repository involves using the Sampler framework with Plaster to generate a standardized project structure. This establishes consistent directories and a reusable build.yaml configuration for end-to-end automated validation.

Does the Sampler framework support GitVersion for automated PowerShell module versioning?

Yes, the Sampler framework integrates GitVersion to handle automated semantic versioning for PowerShell module projects. This ensures consistent version numbers and changelog management across continuous integration runs in GitHub Actions and Azure Pipelines.

Can I use Pester tests within a Sampler pipeline for my PowerShell module?

Yes, you can run Pester tests within a Sampler pipeline to validate PowerShell modules. The framework coordinates Pester alongside ModuleBuilder and InvokeBuild, executing automated test suites across different operating systems as part of the CI/CD workflow.

How do I manage dependencies when building PowerShell modules with InvokeBuild?

Manage PowerShell module build dependencies by configuring them within the Sampler framework's build.yaml file. This centralizes module requirements and coordinates their resolution during the InvokeBuild pipeline execution for consistent automated builds.

Why use ChangelogManagement for PowerShell module releases in CI/CD?

Use ChangelogManagement for PowerShell module releases to automate changelog updates during CI/CD pipelines. Integrated with Sampler, it standardizes release notes and documentation generation across GitHub Actions and Azure Pipelines deployments.