Defame1297
60be7b3232
Only 12 of 39 skills carried metadata.version, and adoption tracked which plugin a skill lived in rather than any stated rule: core, gitea and lint were consistent adopters, bin and kyberforge were consistent non-adopters, git was split with one outlier. There was no documented convention, and skill-author's own bump logic was already written as if presence were conditional. metadata.version is now required on every skill. The 19 skills here that never carried one (bin, kyberforge, gitea-files) are seeded at 1.0.0, not 0.1.0 -- that value stays reserved for a skill's actual creation point under skill-author's existing convention. The skill-frontmatter pre-commit hook now fails a SKILL.md missing the field, the same class of failure as a missing name/description. Full rationale in the new ADR. The git-plugin skills that also need this field follow in the next commit, bundled with issue #113's rtk normalization since both touch the same files. Refs: #127 ADR: 0022 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EeH8SCbcrCAQrtymkNuhKP
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 |