How do I install the Create Apm Package skill?

Run npx skillmds@latest add richfrem/create-apm-package 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 Create Apm Package 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 Create Apm Package?

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 Create Apm Package free to use?

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

Who published Create Apm Package?

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

Create Apm Package by richfrem — Agent Skill

Name: Create Apm Package
Rating: 4.5 (4 reviews)
Author: richfrem

Create Apm Package

Activate when the user wants to create a new APM-native package from scratch for reusable agent skills, agents, commands, hooks, MCP configuration, prompts, or governance-managed agent assets. Do not use this for existing plugin migration; use convert-plugin-to-apm instead.

richfrem 687681a 6 files · 3.5 KB Updated Sep 10, 2026

File contents

create-apm-package Skill 🏗️

Overview

This skill scaffolds a new APM-native package using the "Source in .apm/" pattern. It is used for greenfield projects where APM is the primary distribution format from day one.

🚫 Non-Negotiables

Source in .apm/ — Primitives MUST be authored inside the .apm/ directory.
Kebab-case — Package names must be lowercase with hyphens.
No Overwrites — Never overwrite an existing directory without explicit confirmation.
Governance Docs — Every package must include docs/governance.md.

Decision Tree

New Package? -> Proceed with scripts/scaffold_apm.py.
Existing Plugin? -> Route to convert-plugin-to-apm.
Hybrid needed? -> Use --allow-hybrid flag in scaffold script.

Generated Structure

<package-name>/
  apm.yml
  README.md
  .gitignore
  .apm/
    skills/
    agents/
    instructions/
    prompts/
    hooks/
    mcp/
    scripts/
    tests/
  docs/
    governance.md
    attribution.md
    package-lifecycle.md
  scripts/
  tests/

Validation Steps

After scaffolding, always run:

python scripts/validate_apm_package.py --path ./<package-name>

Anti-Patterns

Duplicate Roots: Creating .apm/skills while also having skills/ in the same package.
Missing Docs: Skipping the docs/ folder in a team or enterprise lane.
Absolute Paths: Using machine-specific paths in apm.yml.

Frequently asked questions