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/auth-and-security.md

View on GitHub
# APM Actions — Auth & Security

## Private Repo Authentication

`github-token` (default `${{ github.token }}`) is auto-forwarded to APM as `GITHUB_APM_PAT`. Same-org private repos work with zero config:

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

### Cross-org Private Repos

Pass a broader-scoped PAT via `github-token`:

```yaml
- uses: microsoft/apm-action@v1
  with:
    github-token: ${{ secrets.APM_PAT }}
```

### Multi-org / Multi-platform (Full Control)

Use the `env:` block for per-source tokens:

```yaml
- uses: microsoft/apm-action@v1
  env:
    GITHUB_APM_PAT: ${{ secrets.APM_PAT }}
    GITHUB_APM_PAT_CONTOSO: ${{ secrets.APM_PAT_CONTOSO }}
    ADO_APM_PAT: ${{ secrets.ADO_PAT }}
    ARTIFACTORY_APM_TOKEN: ${{ secrets.ARTIFACTORY_TOKEN }}
```

An explicit `GITHUB_APM_PAT` in `env:` always wins over the auto-forwarded `github-token` value.

GitHub Actions forbids secrets named with the `GITHUB_` prefix, so a secret literally called `GITHUB_APM_PAT` can't be created. Name cross-org secrets `APM_PAT` (or similar) and pass them via `github-token` or `env: GITHUB_APM_PAT`.

## Security Scanning (`audit-report`)

`apm install` already blocks packages with critical hidden-character (hidden Unicode) findings — no configuration needed. `audit-report` adds visibility: a SARIF report for [Code Scanning](https://docs.github.com/en/code-security/code-scanning) annotations plus a markdown summary in `$GITHUB_STEP_SUMMARY`.

```yaml
- uses: microsoft/apm-action@v1
  id: apm
  with:
    audit-report: true
- uses: github/codeql-action/upload-sarif@v3
  if: always() && steps.apm.outputs.audit-report-path
  with:
    sarif_file: ${{ steps.apm.outputs.audit-report-path }}
    category: apm-audit
```

Works alongside install, update, and pack modes. See the APM security model docs (microsoft.github.io/apm/enterprise/security) for what the scan detects.
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