---
name: release-artifact-generation
description: Use when when a software project has reached a stable milestone (v-tagged commit) and you need to produce official distribution artifacts with verified version metadata, checksums, and release documentation that can be validated against a published GitHub release record.
license: CC-BY-4.0
metadata:
  edam_topics: []
  tools:
  - Semantic Release
derived_from:
- doi: 10.1021/acs.analchem.4c07078
  title: qc4metabolomics
evidence_spans:
- Semantic Release
claims: []
provenance:
  collection: https://w3id.org/holobiomicslab/asb-skill/collection/metabolomics/v1
  assembled_by: scripts/collect_metabolomics_collection.py
  sources:
  - build: coll_qc4metabolomics
    doi: 10.1021/acs.analchem.4c07078
    title: qc4metabolomics
  dedup_kept_from: coll_qc4metabolomics
schema_version: 0.2.0
---

# release-artifact-generation

## Summary

Generate and validate versioned release artifacts (binaries, source distributions, release notes) from a tagged repository state using automated semantic versioning tools. This skill ensures reproducible, traceable software releases with checksummed outputs that match reference records.

## When to use

When a software project has reached a stable milestone (v-tagged commit) and you need to produce official distribution artifacts with verified version metadata, checksums, and release documentation that can be validated against a published GitHub release record.

## When NOT to use

- Repository has no semantic version tags or the target tag does not exist in the repository.
- Reference GitHub release record is unavailable or does not contain checksums for comparison.
- Semantic Release configuration is missing or invalid for the project.

## Inputs

- Git repository at a semantic version tag (e.g., v1.0.0)
- Semantic Release configuration file (e.g., .releaserc or release.config.js)
- Reference GitHub release record (version, artifacts, checksums, release date)

## Outputs

- Versioned release artifacts (binaries, source distributions, tarballs)
- Release notes with version metadata
- Checksum manifest (SHA-256 or equivalent)
- Validation report (artifact/checksum reconciliation against reference)

## How to apply

Retrieve the repository at the target semantic version git tag (e.g., v1.0.0). Configure and execute Semantic Release with appropriate versioning rules to automatically generate versioned artifacts and associated release notes. Extract the generated version number, file contents, and computed checksums. Validate these outputs against the reference GitHub release record by comparing version strings, file integrity (checksum match), and release note content. If all match, the artifact generation was successful and reproducible.

## Related tools

- **Semantic Release** (Automated versioning and artifact generation engine that reads git history and configuration to produce versioned release artifacts and release notes)

## Evaluation signals

- Version number in generated artifact matches the reference GitHub release version number.
- Checksums (SHA-256 or declared algorithm) of generated files match checksums in the reference release record.
- File contents (e.g., binary, tarball, source distribution) are bit-for-bit identical or semantically equivalent to reference artifacts.
- Release notes generated by Semantic Release match or closely align with the reference release notes dated on the reference record.
- All declared artifacts from the reference release are present in the generated output with no extraneous files.

## Limitations

- Artifact reproducibility depends on Semantic Release version and configuration consistency; tool updates may alter output format or checksums.
- Reference release record must include checksums; validation is not possible without them.
- Build environment (dependencies, compiler versions, system libraries) can affect artifact contents for compiled outputs; exact reproducibility may require environment specification.

## Evidence

- [other] Retrieve the QC4Metabolomics repository at the v1.0.0 git tag. Execute Semantic Release with appropriate configuration to generate versioned artifacts and release notes.: "Retrieve the QC4Metabolomics repository at the v1.0.0 git tag. Execute Semantic Release with appropriate configuration to generate versioned artifacts and release notes."
- [other] Validate the generated release artifacts and metadata against the reference GitHub release record dated 2025-07-29 to confirm version number, file contents, and checksums match.: "Validate the generated release artifacts and metadata against the reference GitHub release record dated 2025-07-29 to confirm version number, file contents, and checksums match."