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).

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

StepCommandWhat Happens
1. Scaffoldapm plugin initCreates apm.yml and .apm/ skeleton
2. Compileapm compileTransforms .apm/ → harness-native output (git-diffable)
3. Previewapm preview / apm viewDry-run: confirm what consumers receive
4. Packapm packProduces .zip bundle (+ marketplace.json if configured)
5. Publishapm publishPushes 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

PrimitiveFile PatternFormatKey Frontmatter
Instructions.apm/instructions/*.instructions.mdMarkdowndescription (required), applyTo (glob)
Prompts.apm/prompts/*.prompt.mdMarkdowndescription, mode, tools
Agents.apm/agents/*.agent.mdMarkdownname, description, model, tools
Skills.apm/skills/<name>/SKILL.mdMarkdownname (kebab), description (≤1024 chars)
Hooks.apm/hooks/*.jsonJSONevent, command

Compatibility Matrix (Key Rows)

Primitivecopilotclaudecursorcodexgeminiwindsurfkiro
instructionsnativenativenativecompiledcompilednativenative
promptsnativecompiled → /cmdcompiledunsupportedcompiledcompiledcompiled
agentsnativenativecompiledcompiledunsupportednativeunsupported
skillsnativenativenativenativenativenativenative
hooksnativenativenativenativenativeunsupportednative
MCP serversnativenativenativenativenativenativenative

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

Key Commands

CommandWhat It Does
apm plugin initScaffold a new plugin package with .apm/ skeleton
apm compile [--target <slug>]Transform .apm/ into harness output
apm compile --cleanRemove stale distributed output files
apm preview [<pkg>]Dry-run install; shows what consumers receive
apm view <pkg>Inspect a remote package before installing
apm packProduce .zip bundle (and marketplace.json if configured)
apm publishPush to configured marketplace
apm marketplace initAdd marketplace: block to apm.yml
apm marketplace add <pkg>Add a package entry to the marketplace block
apm lifecycleManage pre/post install/update/uninstall scripts

Reference Files

FileLoad When
references/primitives.mdAuthoring instructions, prompts, agents, skills, hooks; frontmatter fields; file formats
references/compile.mdCompilation strategies, placement, managed-section mode, apm compile flags
references/pack-and-publish.mdapm 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: 471kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall