NetFabric/intelligentium / .agents/skills/apm-producer
apm-producer
FlaggedAuthor 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 | Authoring instructions, prompts, agents, skills, hooks; frontmatter fields; file formats |
| references/compile.md | Compilation strategies, placement, managed-section mode, apm compile flags |
| references/pack-and-publish.md | apm pack, apm publish, marketplace: block in apm.yml, plugin.json, CI release |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |