[docs] Update documentation for features from 2026-05-04

[danielmeppiel]

Documentation Updates - 2026-05-04

This PR updates docs/src/content/docs/reference/cli-commands.md based on features merged in the last 24 hours.

Features Documented

• apm install performance + UX overhaul: parallel BFS, persistent two-tier cache, live progress bar, elapsed time, per-phase --verbose timing (from perf+ux: comprehensive overhaul of apm install (cache, parallel BFS, UX) #1116)
• Cursor slash command support (Cursor 1.6+): .prompt.md -> .cursor/commands/*.md (from feat(cursor): add slash command support for Cursor 1.6+ #1046, shipped in v0.12.1)
• Skill routing convergence: primary skill target is now .agents/skills/ for Copilot, Cursor, OpenCode, Codex, Gemini (from [FEATURE] Support .agents/skills as an apm install target for shared skill deployment #737, shipped in v0.12.0)

Changes Made

• Updated docs/src/content/docs/reference/cli-commands.md:
  • Skill Integration section: corrected primary path from .github/skills/ to .agents/skills/; added --legacy-skill-paths escape hatch note
  • Uninstall table: corrected skill folder row from .github/skills/ to .agents/skills/
  • Cursor auto-detection note: added mention of Cursor 1.6+ slash command deployment (.cursor/commands/*.md)
  • New "Performance and Progress UI" section: documents parallel BFS resolution, persistent two-tier cache with ETag/rev-parse revalidation, live ASCII progress bar, elapsed time, in-run clone dedup
  • Verbose mode description: added mention of per-phase timing output

Merged PRs Referenced

• perf+ux: comprehensive overhaul of apm install (cache, parallel BFS, UX) #1116 - perf+ux: comprehensive overhaul of apm install (cache, parallel BFS, UX)
• feat(cursor): add slash command support for Cursor 1.6+ #1046 - Cursor slash command support (Cursor 1.6+)
• [FEATURE] Support .agents/skills as an apm install target for shared skill deployment #737 - skill routing convergence to .agents/skills/

Notes

PRs #1127 and #1129 were documentation-only PRs that already updated their respective docs pages. PRs #1121, #1124, #1125 were CI/test fixes with no user-facing documentation impact. PR #1112 was the 0.12.0 release cut.

Note

🔒 Integrity filter blocked 2 items

The following items were blocked because they don't meet the GitHub integrity level.

• #1046 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• perf+ux: comprehensive overhaul of apm install (cache, parallel BFS, UX) #1116 pull_request_read: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Daily Documentation Updater · ● 1.8M · ◷

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295

• expires on May 6, 2026, 1:11 PM UTC

[Copilot]

Pull request overview

Updates the apm install and integration-path documentation to reflect recently shipped behavior (install performance/UI work, Cursor command deployment, and converged skill routing), keeping the CLI reference aligned with current defaults.

Changes:

• Adds a new apm install section describing parallel resolution/download, caching, progress UI, and timing output.
• Updates Cursor auto-detection notes to mention Cursor 1.6+ slash command deployment to .cursor/commands/.
• Updates skill path documentation to reflect converged deployment to .agents/skills/ with a --legacy-skill-paths escape hatch, and adjusts the uninstall table accordingly.

Show a summary per file

File	Description
docs/src/content/docs/reference/cli-commands.md	Documents new apm install performance/progress behaviors and updates integration path guidance (Cursor commands + converged skill routing).

Copilot's findings

Comments suppressed due to low confidence (3)

docs/src/content/docs/reference/cli-commands.md:175

• The 'Live progress' bullet reads as unconditional, but the install TUI/progress bar is gated (TTY-only by default, disabled in CI, and controllable via APM_PROGRESS=auto|always|never). Consider documenting those conditions here so readers don't expect a progress bar in non-interactive/CI logs.

- **In-run dedup**: Multiple subdirectory deps from the same repo share one clone per install.
- **Live progress**: An ASCII progress bar shows resolution and download progress in real time.
- **Elapsed time**: Total elapsed time is shown on every exit path (including errors).

docs/src/content/docs/reference/cli-commands.md:351

• This section updates the primary skill path to .agents/skills/, but earlier in this page the 'Dependency Types' section still states that skills are transformed to .github/agents/*.agent.md for VSCode. Please reconcile that earlier statement with the converged skill deployment behavior to avoid internal doc contradictions.

Skills are copied to the converged cross-client directory by default:

- **Primary (converged)**: `.agents/skills/{skill-name}/` — Shared by Copilot, Cursor, OpenCode, Codex, and Gemini
- **Claude**: `.claude/skills/{skill-name}/` — Claude retains its own per-client path
- Pass `--legacy-skill-paths` (or set `APM_LEGACY_SKILL_PATHS=1`) to restore the old per-client layout (`.github/skills/`, `.cursor/skills/`, etc.)

docs/src/content/docs/reference/cli-commands.md:407

• The uninstall 'What Gets Removed' table now calls out .agents/skills/... as the converged location, but the table still lists per-client skill directories (e.g. .cursor/skills/, .opencode/skills/, .gemini/skills/) below. If those are only present when --legacy-skill-paths/APM_LEGACY_SKILL_PATHS=1 is used, consider labeling them as legacy-only (or otherwise clarifying when they apply).

| Integrated chatmodes | `.github/agents/*.agent.md` |
| Claude commands | `.claude/commands/*.md` |
| Skill folders | `.agents/skills/{folder-name}/` (converged); `.claude/skills/` for Claude |
| Integrated hooks | `.github/hooks/*.json` |

• Files reviewed: 1/1 changed files
• Comments generated: 1