From c48c9f54902744c045f16d73b3361b5739697675 Mon Sep 17 00:00:00 2001 From: Defame1297 Date: Mon, 10 Aug 2026 17:43:23 +0000 Subject: [PATCH] feat(kyberforge): add apm-install skill Wraps apm CLI binary install and agent-runtime setup (apm runtime setup/list/status/remove), the bootstrap step ahead of apm-workflow's configure/compile/audit loop. --- .../kyberforge/skills/apm-install/README.md | 22 ++++++++ .../kyberforge/skills/apm-install/SKILL.md | 53 +++++++++++++++++++ .../skills/apm-install/references/sources.md | 9 ++++ 3 files changed, 84 insertions(+) create mode 100644 plugins/kyberforge/skills/apm-install/README.md create mode 100644 plugins/kyberforge/skills/apm-install/SKILL.md create mode 100644 plugins/kyberforge/skills/apm-install/references/sources.md diff --git a/plugins/kyberforge/skills/apm-install/README.md b/plugins/kyberforge/skills/apm-install/README.md new file mode 100644 index 0000000..5cacb8f --- /dev/null +++ b/plugins/kyberforge/skills/apm-install/README.md @@ -0,0 +1,22 @@ +# apm-install + +Installs and configures the `apm` (Agent Package Manager) CLI and the agent runtimes it manages. + +## What it does + +Covers the two provisioning steps for working with apm: installing the `apm` binary itself (quick-install script, pinned version, air-gapped mirror, or pip), and installing/managing an agent runtime apm drives (`apm runtime setup copilot|codex|gemini|llm`, listing installed runtimes, checking which one `apm run` defaults to). + +## Usage + +``` +/apm-install +``` + +Once `apm` and a runtime are in place, use `apm-workflow` for authoring `apm.yml`, scaffolding packages/marketplaces, compiling, packing, publishing, and auditing. + +## Files + +| File | Purpose | +|------|---------| +| `SKILL.md` | Skill instructions for agents | +| `references/sources.md` | Provenance chain — research sources that informed this skill | diff --git a/plugins/kyberforge/skills/apm-install/SKILL.md b/plugins/kyberforge/skills/apm-install/SKILL.md new file mode 100644 index 0000000..318f0b3 --- /dev/null +++ b/plugins/kyberforge/skills/apm-install/SKILL.md @@ -0,0 +1,53 @@ +--- +name: apm-install +description: > + Use when the user wants to install the apm (Agent Package Manager) CLI + itself, pin or upgrade its version, set up an air-gapped/enterprise mirror + install, or install and manage an agent runtime that apm drives (Copilot + CLI, Codex, Gemini, generic llm) — "install apm", "set up apm", "pin apm to + a version", "apm runtime setup", "which runtime will apm run pick". Do not + use for authoring apm.yml, scaffolding a package/marketplace, compiling, + packing, publishing, or running apm audit — use apm-workflow for those. +metadata: + category: apm + source_keys: + - context7-microsoft-apm +--- + +## Gotchas + +- apm does not execute agents itself — it only installs and manages the runtimes that do. "Install apm" and "install a runtime apm manages" are two separate steps; don't conflate them or skip the second when the user actually wants a working agent CLI, not just the package manager. +- The air-gapped/enterprise mirror path needs `GITHUB_URL` and `VERSION` set together against a downloaded `install.sh` — it does not work through the piped one-liner form. +- `pip install apm-cli` requires Python 3.10+; the quick-install script has no such prerequisite. Prefer the quick-install script unless the environment is pip-first. +- Installing the Copilot CLI runtime through `apm runtime setup copilot` requires Node.js v22+ and npm v10+ already present — apm does not install Node/npm for you. + +## Install apm + +Default: + +```bash +curl -sSL https://aka.ms/apm-unix | sh +``` + +Escape hatches — combine as needed: +- Pin a version: append `@vX.Y.Z` to the piped script's arguments, e.g. `curl -sSL https://aka.ms/apm-unix | sh -s -- @v1.2.3`. +- Custom install directory: set `APM_INSTALL_DIR` before running, e.g. `APM_INSTALL_DIR=$HOME/.local/bin sh`. +- Air-gapped / GitHub Enterprise mirror: download `install.sh` first, then run it with `GITHUB_URL` and `VERSION` set, e.g. `GITHUB_URL=https://github.corp.com VERSION=v1.2.3 sh install.sh`. +- pip (Python 3.10+ environments): `pip install apm-cli`. +- Manual: download the platform archive from the GitHub releases page, extract, place the binary on `PATH`. + +Verify with `apm --version`. + +## Install or manage an agent runtime + +Default: + +```bash +apm runtime setup copilot +``` + +Other targets: `apm runtime setup codex`, `apm runtime setup gemini`, `apm runtime setup llm`. + +- `apm runtime list` — show installed runtimes. +- `apm runtime status` — show which runtime `apm run` will pick by default. +- `apm runtime remove -y` — uninstall without an interactive prompt. diff --git a/plugins/kyberforge/skills/apm-install/references/sources.md b/plugins/kyberforge/skills/apm-install/references/sources.md new file mode 100644 index 0000000..1d8a50a --- /dev/null +++ b/plugins/kyberforge/skills/apm-install/references/sources.md @@ -0,0 +1,9 @@ +# Sources + +## context7-microsoft-apm + +- **URL:** context7:/microsoft/apm +- **Description:** Microsoft APM (Agent Package Manager) — open-source dependency manager for AI agent configuration (skills, prompts, instructions, agents, hooks, MCP/LSP deps), applying a declare/lock/install/audit workflow. +- **Research doc:** plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md +- **Contributing files:** SKILL.md +- **Status:** `extracted`