Skills now migrate from hand-authored plugin.json to Microsoft APM (apm.yml + .apm/) per ADR-0015/issue #89. skill-author's write location switches accordingly: walk up from the destination to the nearest ancestor apm.yml declaring a type: field (skipping type:-less marketplace-only manifests) and scaffold into <package-root>/.apm/skills/ <name>/. Standalone authoring (no apm.yml/.git anywhere, e.g. ~/.agents/skills/) is unchanged — only the old plugin.json-based path is replaced, not standalone mode. 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 |