Skip to content

NetFabric/intelligentium / .agents/skills/apm-actions

apm-actions

Verified

Configure and use the microsoft/apm-action GitHub Action for CI/CD workflows. Use when: writing workflows that install/pack/restore APM agent primitives; install mode (apm install from apm.yml); isolated mode (inline dependencies, no apm.yml); setup-only mode; update mode (refresh branch/tag refs, apm update --yes); pack mode (.tar.gz bundles); bundle-format apm vs plugin; restore mode (bundle:, apm unpack); multi-bundle restore (bundles-file); release mode (tag-triggered publish pipeline); cross-job artifact workflows; apm-action inputs/outputs; audit-report SARIF security scanning; private repo / cross-org authentication (GITHUB_APM_PAT); marketplace artifact publishing from CI; troubleshooting apm-action mutual-exclusivity errors. DO NOT USE FOR: local apm CLI usage as a consumer (use apm-consumer); authoring/publishing packages, apm.yml marketplace block, plugin.json (use apm-producer).

FileKindSize
SKILL.mdskill md3.5 KB
references/auth-and-security.mdmarkdown1.8 KB
references/inputs-outputs.mdmarkdown3.6 KB
references/modes.mdmarkdown2.0 KB
references/pack-and-restore.mdmarkdown5.2 KB

references/modes.md

View on GitHub
# APM Actions — Modes

## Default Install

```yaml
- uses: microsoft/apm-action@v1
```

Installs CLI, reads `apm.yml`, runs `apm install`.

### With Options

```yaml
- uses: microsoft/apm-action@v1
  with:
    compile: 'true'                    # generate AGENTS.md after install
    apm-version: '0.7.0'               # pin a specific APM version
    working-directory: './my-project'  # custom working directory
```

## Isolated Mode

Ignore `apm.yml`; install only inline deps. No `apm.yml` needed.

```yaml
- uses: microsoft/apm-action@v1
  with:
    isolated: 'true'
    dependencies: |
      - microsoft/apm-sample-package
```

## Setup-only Mode

Install CLI + `PATH` only, like `actions/setup-node`. No `apm.yml` read, no install/deploy. Mutually exclusive with `pack`, `bundle`, `bundles-file`. Sets `apm-version`/`apm-path` outputs.

```yaml
- uses: microsoft/apm-action@v1
  id: apm
  with:
    setup-only: 'true'
    apm-version: '0.11.0'
- run: apm --version
- run: apm pack -o build --format plugin
```

## Update Mode

Runs `apm update --yes` instead of `apm install`: re-resolves every branch/tag ref to its latest matching commit, rewrites `apm.lock.yaml`, deploys refreshed assets. Requires `apm.yml` in the working directory. Composes with `audit-report`, `compile`, `script`, `dependencies`, `pack`. Mutually exclusive with `isolated`, `setup-only`, `bundle`, `bundles-file`, `mode`.

```yaml
name: Refresh AI agent assets
on:
  schedule:
    - cron: '0 6 * * 1'   # Monday 06:00 UTC
  workflow_dispatch:

jobs:
  apm-update:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: microsoft/apm-action@v1
        with:
          update: 'true'
          audit-report: 'true'
      - uses: peter-evans/create-pull-request@v6
        with:
          title: 'chore: update AI agent assets'
          branch: apm/auto-update
```

Pack, restore, and release modes: [references/pack-and-restore.md](pack-and-restore.md).
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall