How do I install the Convert Plugin To Apm skill?

Run npx skillmds@latest add richfrem/convert-plugin-to-apm in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Convert Plugin To Apm safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Convert Plugin To Apm?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Convert Plugin To Apm free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Convert Plugin To Apm?

richfrem (@richfrem) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Convert Plugin To Apm by richfrem — Agent Skill

Name: Convert Plugin To Apm
Rating: 4.666666666666667 (3 reviews)
Author: richfrem

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.

richfrem 0ef4d9f 6 files · 3.7 KB Updated Sep 10, 2026

File contents

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

Frequently asked questions