agentsclimarketplace
Sign in

Convert plugin to apm

Skill richfrem/agent-plugins-skills/plugins/agent-scaffolders/skills/convert-plugin-to-apm

Activate when the user wants to add APM governance, lockfile/audit readiness, or multi-runtime package management to an existing Claude/Copilot/agent plugin, or explicitly convert a plugin into an APM-native package.From its SKILL.md

Install
npx -y skills add richfrem/agent-plugins-skills --skill convert-plugin-to-apm

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.7 KB, 355 tokens by cl100k_base, as published. Nobody here has run it

convert-plugin-to-apm Skill 🔄

Overview

This skill implements the Overlay-First migration strategy. It allows existing plugins to gain APM governance without the "repackaging tax" of moving files, unless explicitly requested.

Migration Modes

1. Overlay Mode (Default)

Use when: The plugin is active and its current layout is preferred.

  • Action: Add apm.yml and docs/governance.md to the root.
  • Benefit: Zero disruption to existing npx skills or Claude Code workflows.

2. Hybrid Mode

Use when: You want to keep the plugin layout but start adding new APM-native assets.

  • Action: Add .apm/ for new governance assets; keep existing primitives in place.

3. Full Conversion

Use when: You want a clean, APM-native package structure.

  • Action: Create a new directory and migrate all primitives into .apm/.
  • Note: Always preserve the original plugin untouched.

🎯 Primary Directive

Do not force .apm/ as the new source of truth unless explicitly requested.

Validation & Audit

After conversion, run:

python scripts/validate_apm_package.py --path <target-path>

Mapping Rules (Full Mode)

  • .claude-plugin/plugin.json -> Metadata for apm.yml
  • skills/* -> .apm/skills/*
  • agents/* -> .apm/agents/*
  • commands/* -> .apm/prompts/* (APM standard)
  • hooks/hooks.json -> .apm/hooks/hooks.json

What ships with it: 5 files

2.0 KB alongside SKILL.md, 1 of them executable

evals/

scripts/

Keep looking

Skills are one crate of 326,861. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.