From 9f715c8649ddc62713ad8582a8d99d02eb3116ae Mon Sep 17 00:00:00 2001 From: Daniel Meppiel <51440732+danielmeppiel@users.noreply.github.com> Date: Tue, 28 Apr 2026 15:15:35 +0200 Subject: [PATCH 1/2] docs: add 'Coming from npx skills add' migration section Add a dedicated section to the migration guide for users arriving from the npx skills add / agentskills.io ecosystem. Covers the drop-in install gesture, --skill flag for selective installs, and persistent selection across machines. This mirrors the README migration table added in v0.10.0 (#980) and brings the docs site to parity. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../content/docs/getting-started/migration.md | 35 ++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/getting-started/migration.md b/docs/src/content/docs/getting-started/migration.md index 78a06b93b..8a88cf3e1 100644 --- a/docs/src/content/docs/getting-started/migration.md +++ b/docs/src/content/docs/getting-started/migration.md @@ -1,6 +1,6 @@ --- title: "Existing Projects" -description: "Add APM to a project that already has AI agent configuration." +description: "Add APM to a project that already has AI agent configuration, or migrate from npx skills add." sidebar: order: 5 --- @@ -54,6 +54,39 @@ If you decide APM is not for you: No uninstall script, no cleanup command. Zero risk. +## Coming from `npx skills add` + +APM is a drop-in replacement. The install gesture is identical, and you also +get a manifest, lockfile, and reproducible installs across machines. + +```bash +# Install a whole skill bundle (equivalent to: npx skills add vercel-labs/agent-skills) +apm install vercel-labs/agent-skills + +# Install a single skill from a bundle and persist the selection to apm.yml +apm install vercel-labs/agent-skills --skill deploy-to-vercel + +# Subsequent bare apm install respects the persisted selection +apm install +``` + +The `--skill` flag is repeatable. Your selection is written to `apm.yml` and +`apm.lock.yaml` so the exact subset is reproducible on every machine. + +```bash +# Pick two skills, then reset to all +apm install vercel-labs/agent-skills --skill deploy-to-vercel --skill preview +apm install vercel-labs/agent-skills --skill '*' # back to full bundle +``` + +Any public repo that works with `npx skills add owner/repo` also works with +`apm install owner/repo`. APM recognises bare `skills//SKILL.md` +layouts (the [agentskills.io](https://agentskills.io) convention) as a +first-class package type; `apm.yml` is optional. + +See [Package Types](../../reference/package-types/#skill-collection-skillsnameskillmd) for the full +skill collection layout reference. + ## Next steps - [Quick start](../quick-start/) — first-time setup walkthrough From 5df5c875a4a7fd978281e2e0849bf29e1fe9da81 Mon Sep 17 00:00:00 2001 From: Copilot Date: Thu, 30 Apr 2026 17:53:48 +0200 Subject: [PATCH 2/2] docs: address Copilot review on migration page (#1016) - Use American spelling 'recognizes' for consistency - Replace non-ASCII em/en dashes with ASCII per repo policy Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/src/content/docs/getting-started/migration.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/src/content/docs/getting-started/migration.md b/docs/src/content/docs/getting-started/migration.md index 8a88cf3e1..403c20a0d 100644 --- a/docs/src/content/docs/getting-started/migration.md +++ b/docs/src/content/docs/getting-started/migration.md @@ -5,7 +5,7 @@ sidebar: order: 5 --- -APM is additive. It never deletes, overwrites, or modifies your existing configuration files. Your current `.github/copilot-instructions.md`, `AGENTS.md`, `.claude/` config, `.cursor-rules` — all stay exactly where they are, untouched. +APM is additive. It never deletes, overwrites, or modifies your existing configuration files. Your current `.github/copilot-instructions.md`, `AGENTS.md`, `.claude/` config, `.cursor-rules` -- all stay exactly where they are, untouched. ## Add APM in three steps @@ -80,7 +80,7 @@ apm install vercel-labs/agent-skills --skill '*' # back to full bundle ``` Any public repo that works with `npx skills add owner/repo` also works with -`apm install owner/repo`. APM recognises bare `skills//SKILL.md` +`apm install owner/repo`. APM recognizes bare `skills//SKILL.md` layouts (the [agentskills.io](https://agentskills.io) convention) as a first-class package type; `apm.yml` is optional. @@ -89,7 +89,7 @@ skill collection layout reference. ## Next steps -- [Quick start](../quick-start/) — first-time setup walkthrough -- [Dependencies](../../guides/dependencies/) — managing external packages -- [Manifest schema](../../reference/manifest-schema/) — full `apm.yml` reference -- [CLI commands](../../reference/cli-commands/) — complete command reference +- [Quick start](../quick-start/) -- first-time setup walkthrough +- [Dependencies](../../guides/dependencies/) -- managing external packages +- [Manifest schema](../../reference/manifest-schema/) -- full `apm.yml` reference +- [CLI commands](../../reference/cli-commands/) -- complete command reference