federalavd-artifact-authoring

Create, update, and validate FederalAVD image artifacts and software download definitions. Use when adding customer-example artifacts, editing downloads.json, packaging installers, documenting download sources, or preparing artifacts for connected or air-gapped image builds.

Jump to install

Repository: Azure/FederalAVD
Last source activity: August 18, 2026 at 18:24
Detected SKILL.md language: English
Stars: 17
Forks: 19

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Azure/FederalAVD --skill federalavd-artifact-authoring

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

FederalAVD Artifact Authoring

Use this workflow for content under customer-examples/artifacts/ and entries in customer-examples/parameters/imageManagement/downloads.json.

Procedure

Read docs/artifacts-guide.md and docs/update-image-artifacts.md.

Inspect a neighboring artifact that uses the same installer or package type.

Keep customer-specific content out of the example. Tell users to copy examples into the git-ignored customer/artifacts/ folder before customization.

Select the source supported by deployments/Update-ImageArtifacts.ps1: DownloadUrl, APIUrl, GitHubRepo, or WingetId.

Make DestinationFileName match the filename consumed by the installation script.

Set every DestinationFolders value to the exact artifact folder name. An empty destination is allowed only when the package is intentionally copied to the artifact root.

Document the authoritative source, exact connected download command, -OutFile filename, expected folder, and offline transfer procedure in the artifact README.

For public endpoints or runtime downloads, review docs/air-gapped-clouds.md and document the pre-staging alternative. Do not use WingetId as an air-gapped strategy.

Keep every .ps1 file ASCII-only.

Run the bundled validator from the repository root:

& .github/skills/federalavd-artifact-authoring/scripts/Test-ArtifactPackage.ps1 ` -ArtifactPath customer-examples/artifacts/<ArtifactFolder>

Run the narrowest behavior test available for the changed installer or packaging path.

Report source URLs that could not be verified and files that must be manually staged.

See the review checklist before completing the change.

name	federalavd-artifact-authoring
description	Create, update, and validate FederalAVD image artifacts and software download definitions. Use when adding customer-example artifacts, editing downloads.json, packaging installers, documenting download sources, or preparing artifacts for connected or air-gapped image builds.
argument-hint	[artifact folder or software name]