Files
holocron/plugins/kyberforge/skills/apm-workflow/README.md
Defame1297 dac9cad912 refactor(kyberforge): move audit guidance out of the per-run rubric load
skill-audit loaded roughly 4,268 words of rubric on every run, most of it
criteria for findings a clean skill never triggers. The auditing guidance moves
into finding-criteria.md, read only when a finding is actually raised, cutting
a clean audit to about 999 words. The named-skill exemption is replaced with
properties, so the rubric stops carrying a list that ages the moment a skill
is renamed.

apm-workflow's `type:` trap sat in one flow while biting several, so it is
promoted to a common gate reachable from all of them; its claim to be
self-contained was untrue once it started routing to apm-install. skill-author's
contract had drifted from body-discipline.md and is realigned, and agent-audit's
field inventory is brought in line with the same split.
2026-08-31 08:02:19 +00:00

1.9 KiB

apm-workflow

Authors, scaffolds, compiles, and audits apm packages and marketplaces.

What it does

Covers the apm.yml lifecycle a session moves through repeatedly: configuring/scaffolding a package manifest, resolving/fetching its declared dependencies, building or registering a marketplace, compiling/packing/publishing a distributable, and validating integrity via apm audit. Dispatches on the resolved flow to one of five reference files; each carries that flow's traps and names a sibling file where one flow genuinely depends on another's detail.

Before you start

Requires the apm binary and (for runtime-driven scripts) an agent runtime already installed — use apm-install first if either is missing.

Usage

/apm-workflow configure
/apm-workflow install
/apm-workflow marketplace
/apm-workflow compile
/apm-workflow audit

Files

File Purpose
SKILL.md Dispatch table and the three gotchas common to every branch (MCP secret indirection, the experimental enable registries precondition, the unchecked type: field)
references/configure.md apm.yml schema, apm plugin init, dependency forms, MCP secrets, includes:, registries; type: and experimental enable registries traps
references/install.md apm install, apm install [PACKAGE_REF], --update, --target agent-skills
references/marketplace.md Building/registering a marketplace, marketplace add vs package add, package registration, versioning, Claude Code reserved-name/publish-confirm gotchas
references/compile.md apm compile / pack / publish / run, claude plugin validate agents/ gotcha
references/audit.md apm audit vs apm audit --ci (they check different things), apm marketplace check, CI wiring, frozen installs, claude plugin validate terminal check
references/sources.md Provenance chain — research sources that informed this skill