Validates the new single-file .apm/agents/<name>.agent.md shape agent-author now produces at plugin/APM scope: frontmatter allowlist (name/description/ model only, from a new apm-agent-allowlist entry in field-inventory.md), no counterpart derivation, and Pair Consistency dropped from that scope's report entirely (nothing to pair by design). Adds a plugin/APM-scope-only SUGGESTION when an agent's description/body implies a tool restriction or Claude-only behavior the vendor-neutral frontmatter can no longer express (ADR-0016). Scope detection in both validate.sh and validate-provenance.sh switches from a flat plugin.json/.claude-plugin/plugin.json check to a walk-up for the nearest ancestor apm.yml with a top-level type: field, skipping type:-less marketplace-only manifests — full switch, no dual-mode fallback to the old plugin.json signal. validate-provenance.sh's walk-up was fixed to match validate.sh's (it still used the old plugin.json check, and its counterpart-merge logic was rewritten to read a single file's source_keys instead of merging a CC+Copilot pair, since plugin/APM scope has no counterpart). Project/user scope validation is unchanged in both scripts. Refs: #89
skills/
Skills for this plugin. Each skill lives in its own subdirectory:
skills/
<skill-name>/
SKILL.md # required — frontmatter + skill body
META.md # required — provenance and audit fields
references/ # optional — on-demand reference docs
scripts/ # optional — executable helper scripts
assets/ # optional — templates, data files, lookup tables
Shared — both Claude Code and GitHub Copilot CLI read skills/<name>/SKILL.md.
To create or improve a skill, run /skill-author in a Claude Code session. To review a skill
without modifying it, run /skill-audit. Do not write SKILL.md by hand without following the
authoring standard — trigger descriptions and body discipline are required.
Skills
| Skill | Description |
|---|---|
skill-author |
Create or improve a skill from scratch, audit findings, or inline feedback |
skill-audit |
Audit a skill directory against the agentskills.io spec and produce a findings report |
agent-author |
Author an agent definition file |
pc-author |
Create, add, remove, and configure .pre-commit-config.yaml |
pc-run |
Install, run, autoupdate, and maintain the pre-commit setup |
plugin-author |
(Deprecated — see apm-workflow) Create, update, and release plugin scaffolds for the holocron marketplace |
marketplace-author |
(Deprecated — see apm-workflow) Add, remove, and update plugin entries in the holocron marketplace manifest |
apm-install |
Install or upgrade the apm CLI and set up the agent runtimes it drives (Copilot CLI, Codex, Gemini, generic llm) |
apm-workflow |
Author apm.yml, scaffold an apm package/marketplace, install dependencies, and compile/pack/publish/audit apm content |