Defame1297
dac9cad912
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.
34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# 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 |
|