alpine-aports-docs

Reference APKBUILD metadata, abuild workflows, and aports commit policies.

7|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/wenerme/ai --skill alpine-aports-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alpine-aports-docs
Source: https://github.com/wenerme/ai/tree/main/skills/alpine-aports-docs
Command: npx skills add https://github.com/wenerme/ai --skill alpine-aports-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of uncertainty and inconsistency when maintaining Alpine Linux packages in aports by providing a single, practical reference for correct APKBUILD and abuild workflows.

Core Features & Use Cases

  • APKBUILD maintainer workflow guidance: Covers required metadata (pkgname/pkgver/pkgrel/pkgdesc/url/arch/license), subpackages patterns, common options, and the expected function order for fetch→unpack→prepare→build→check→package.
  • abuild and apk command reference: Provides the typical command flow for building, debugging, checksum updates, and dependency handling, plus where to find detailed apk packaging internals.
  • aports contribution and commit policy: Includes repository structure expectations (testing/community/main) and strict commit message formatting for add/upgrade/rebuild/move/rename/remove.

Use case example: You are upgrading an existing a port and need to update pkgver/pkgrel, regenerate sha512sums, run abuild -r, and produce a correctly formatted commit message for community or main.

Quick Start

Ask the Skill to generate an upgrade plan for an Alpine a port (including which APKBUILD fields to change, when to run abuild checksum, and what commit message to use) for your target pkgname and new upstream version.

Frequently Asked Questions about alpine-aports-docs

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

FAQPage Schema
How do I write an APKBUILD file for maintaining an Alpine Linux package?

Writing an APKBUILD file for Alpine Linux packages requires specific metadata like pkgname, pkgver, pkgrel, and license, alongside a deterministic function order for fetch, unpack, prepare, build, check, and package.

What is the correct commit message format for submitting Alpine aports contributions?

Correct Alpine aports commit messages follow strict formatting rules based on the action type, such as add, upgrade, rebuild, move, rename, or remove, while adhering to the repository structure of testing, community, or main.

How do I update checksums when upgrading an Alpine Linux aport?

Updating checksums for an Alpine Linux aport involves modifying the pkgver and pkgrel fields in your APKBUILD, then executing abuild checksum to regenerate the required sha512sums before running the final build.

What is the expected abuild workflow for building and validating an APKBUILD?

The expected abuild workflow for validating an APKBUILD follows a deterministic sequence of fetch, unpack, prepare, build, check, and package functions, utilizing abuild and apk commands to manage dependencies and execute builds.

Can I use this reference for reviewing APKBUILD subpackages and common options?

You can use this reference to review APKBUILD subpackages patterns and common options, as it provides maintainer-focused guidance for ensuring accurate metadata and validating build configurations in Alpine aports.

Why does my Alpine Linux package build fail after changing the upstream version?

Alpine Linux package builds frequently fail after version changes if sha512sums are not regenerated via abuild checksum, or if the deterministic function ordering in the APKBUILD is not correctly maintained.