[docs] Update documentation for features from 2026-04-28#1016
Open
danielmeppiel wants to merge 1 commit intomainfrom
Open
[docs] Update documentation for features from 2026-04-28#1016danielmeppiel wants to merge 1 commit intomainfrom
danielmeppiel wants to merge 1 commit intomainfrom
Conversation
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>
danielmeppiel
added
automation
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the docs site migration guide to include an explicit migration path for users coming from the npx skills add ecosystem, aligning the docs site with the recently-added README conversion block.
Changes:
- Expand the migration page frontmatter description to mention migration from
npx skills add. - Add a new "Coming from
npx skills add" section documenting drop-in install parity,--skillsubset installs, persistence behavior, and reset-to-all via--skill '*'. - Add a link to the Package Types reference for the full skill collection layout.
Show a summary per file
| File | Description |
|---|---|
| docs/src/content/docs/getting-started/migration.md | Adds a migration section for npx skills add users and updates page description accordingly. |
Copilot's findings
Comments suppressed due to low confidence (1)
docs/src/content/docs/getting-started/migration.md:95
- This page still contains non-ASCII em dashes ("—") in the Next steps list. Project guideline requires printable ASCII in docs/CLI strings to avoid Windows cp1252 encoding errors; please replace these with ASCII equivalents (e.g., "--" or "-").
- [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
- Files reviewed: 1/1 changed files
- Comments generated: 1
| ``` | ||
|
|
||
| Any public repo that works with `npx skills add owner/repo` also works with | ||
| `apm install owner/repo`. APM recognises bare `skills/<name>/SKILL.md` |
There was a problem hiding this comment.
Spelling inconsistency: docs elsewhere use American English (e.g., "recognizes"), but this section uses "recognises". Please change to "recognizes" for consistency.
Suggested change
| `apm install owner/repo`. APM recognises bare `skills/<name>/SKILL.md` | |
| `apm install owner/repo`. APM recognizes bare `skills/<name>/SKILL.md` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation Updates - 2026-04-28
This PR updates the documentation based on features merged in the last 24 hours.
Features Documented
npx skills addmigration path (from docs(readme): add 'Coming from npx skills add?' conversion block #980, shipped in v0.10.0)Changes Made
docs/src/content/docs/getting-started/migration.mdto add a "Coming fromnpx skills add" section covering:--skillflag for selective installs, persisted toapm.yml--skill '*'to reset to full bundleMerged PRs Referenced
npx skills add?" 30-second migration table (v0.10.0)npx skills add#974 - Day-0 install parity withnpx skills add/ SKILL_BUNDLE support (v0.9.4)Notes
The v0.10.0 release added a migration table to the README for users arriving from the agentskills.io /
npx skills addecosystem. This PR brings the docs site to parity by adding an equivalent section to the migration guide, which is the natural discovery point for users switching tooling.All other v0.10.0 and v0.9.4 user-facing features (Cowork integration, marketplace authoring CLI, air-gapped installer env vars,
--skillflag) were already documented in the docs site prior to this PR.