Skip to content

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

apm-producer

Flagged

Author and publish APM packages: create primitives, compile, pack, and distribute. Use when: apm plugin init; authoring under .apm/ (skills, prompts, agents, instructions, hooks, commands); SKILL.md authoring; .prompt.md; .agent.md; .instructions.md frontmatter; apm compile strategies (distributed vs single-file); apm preview; apm view; apm pack bundles; apm publish; apm marketplace init / add / update; plugin.json; marketplace block in apm.yml; apm lifecycle; package-relative links; versioning; releasing from CI; dev-only primitives; devDependencies. Covers: .apm/ layout, primitive-to-target compatibility matrix, compilation placement, bundle format, marketplace.json. DO NOT USE FOR: installing packages from others (use apm-consumer); org-wide policy enforcement (apm-policy.yml).

FileKindSize
SKILL.mdskill md4.6 KB
references/compile.mdmarkdown3.9 KB
references/pack-and-publish.mdmarkdown5.3 KB
references/primitives.mdmarkdown4.5 KB
---
name: apm-producer
description: "Author and publish APM packages: create primitives, compile, pack, and distribute. Use when: apm plugin init; authoring under .apm/ (skills, prompts, agents, instructions, hooks, commands); SKILL.md authoring; .prompt.md; .agent.md; .instructions.md frontmatter; apm compile strategies (distributed vs single-file); apm preview; apm view; apm pack bundles; apm publish; apm marketplace init / add / update; plugin.json; marketplace block in apm.yml; apm lifecycle; package-relative links; versioning; releasing from CI; dev-only primitives; devDependencies. Covers: .apm/ layout, primitive-to-target compatibility matrix, compilation placement, bundle format, marketplace.json. DO NOT USE FOR: installing packages from others (use apm-consumer); org-wide policy enforcement (apm-policy.yml)."
---

# APM Producer

An APM package is a directory with `apm.yml` + a `.apm/` source tree. `apm compile` transforms `.apm/` into per-harness output; `apm pack` bundles it for distribution.

## Producer Ladder

| Step | Command | What Happens |
|------|---------|-------------|
| 1. Scaffold | `apm plugin init` | Creates `apm.yml` and `.apm/` skeleton |
| 2. Compile | `apm compile` | Transforms `.apm/` → harness-native output (git-diffable) |
| 3. Preview | `apm preview` / `apm view` | Dry-run: confirm what consumers receive |
| 4. Pack | `apm pack` | Produces `.zip` bundle (+ `marketplace.json` if configured) |
| 5. Publish | `apm publish` | Pushes to marketplace; consumers install via `apm install` |

Steps 4–5 are optional for internal distribution; a git repo alone is enough.

## `.apm/` Source Layout

```
.apm/
├── instructions/       # Always-on rules scoped by file glob
├── skills/<name>/      # Multi-file capabilities (SKILL.md + assets)
├── prompts/            # Reusable prompt templates
├── agents/             # Specialized agent personas
├── context/            # Shared fragments referenced by other primitives
└── hooks/              # Lifecycle event handlers
```

## Primitive Types

| Primitive | File Pattern | Format | Key Frontmatter |
|-----------|-------------|--------|-----------------|
| Instructions | `.apm/instructions/*.instructions.md` | Markdown | `description` (required), `applyTo` (glob) |
| Prompts | `.apm/prompts/*.prompt.md` | Markdown | `description`, `mode`, `tools` |
| Agents | `.apm/agents/*.agent.md` | Markdown | `name`, `description`, `model`, `tools` |
| Skills | `.apm/skills/<name>/SKILL.md` | Markdown | `name` (kebab), `description` (≤1024 chars) |
| Hooks | `.apm/hooks/*.json` | JSON | `event`, `command` |

## Compatibility Matrix (Key Rows)

| Primitive | copilot | claude | cursor | codex | gemini | windsurf | kiro |
|-----------|---------|--------|--------|-------|--------|----------|------|
| instructions | native | native | native | compiled | compiled | native | native |
| prompts | native | compiled → `/cmd` | compiled | unsupported | compiled | compiled | compiled |
| agents | native | native | compiled | compiled | unsupported | native | unsupported |
| skills | native | native | native | native | native | native | native |
| hooks | native | native | native | native | native | unsupported | native |
| MCP servers | native | native | native | native | native | native | native |

`compiled` = APM transforms the file to the harness's own format. `unsupported` = not delivered.

## Key Commands

| Command | What It Does |
|---------|-------------|
| `apm plugin init` | Scaffold a new plugin package with `.apm/` skeleton |
| `apm compile [--target <slug>]` | Transform `.apm/` into harness output |
| `apm compile --clean` | Remove stale distributed output files |
| `apm preview [<pkg>]` | Dry-run install; shows what consumers receive |
| `apm view <pkg>` | Inspect a remote package before installing |
| `apm pack` | Produce `.zip` bundle (and `marketplace.json` if configured) |
| `apm publish` | Push to configured marketplace |
| `apm marketplace init` | Add `marketplace:` block to `apm.yml` |
| `apm marketplace add <pkg>` | Add a package entry to the marketplace block |
| `apm lifecycle` | Manage `pre/post install/update/uninstall` scripts |

## Reference Files

| File | Load When |
|------|-----------|
| [references/primitives.md](references/primitives.md) | Authoring instructions, prompts, agents, skills, hooks; frontmatter fields; file formats |
| [references/compile.md](references/compile.md) | Compilation strategies, placement, managed-section mode, `apm compile` flags |
| [references/pack-and-publish.md](references/pack-and-publish.md) | `apm pack`, `apm publish`, `marketplace:` block in `apm.yml`, `plugin.json`, CI release |
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall