Skip to content

apm-yaml-valid

apm.yml must exist with valid YAML and required fields (name, version, description)
Severity error (auto)
Autofix -
Since v0.7.0
Category APM (Agent Package Manager)

Why

apm.yml is the manifest for an APM (Agent Package Manager) repository. Missing or invalid YAML, or missing required fields (name, version, description), means the package manager cannot identify or version the repository.

Examples

Bad:

name: my-package

Good:

name: my-package
version: "1.0.0"
description: Shared coding assistant skills for the frontend team

How to fix

Create apm.yml at the repository root (if missing) and add the required fields: name, version, and description. Fix any YAML syntax errors reported in the violation message.

Configuration

rules:
  apm-yaml-valid:
    enabled: auto  # true | false | auto
    severity: error

Run skillsaw explain apm-yaml-valid to see this documentation and the rule's effective configuration in your terminal.