Skip to content

richfrem/agent-plugins-skills / plugins/agent-extension-authoring/.apm/skills/packaging-with-apm

packaging-with-apm

Flagged

Packages, installs and distributes agent extensions with APM (Agent Package Manager). Use when the user wants to create a new APM package, convert or migrate an existing plugin to APM and check it installs cleanly, compile a package into AGENTS.md, CLAUDE.md or GEMINI.md, install, update, pin or roll back packages globally or per project, or create a plugin marketplace catalog (marketplace.json). Not for authoring a single skill, plugin, sub-agent or rule (use the authoring-* skills).

FileKindSize
SKILL.mdskill md5.3 KB
evals/evals.jsonconfig2.7 KB
examples/marketplace.jsonconfig45 B
references/acceptance-criteria.mdmarkdown4.6 KB
references/agent-package-manager-overview.mdmarkdown28.7 KB
references/apm-alignment-fixes.mdmarkdown5.3 KB
references/diagrams/packaging-with-apm-flow.mmdother590 B
references/fallback-tree.mdmarkdown1.8 KB
references/legacy-plugin-conversion-guide.mdmarkdown15.4 KB
references/marketplace-architecture.mdmarkdown1.5 KB
references/marketplace-schema.mdmarkdown2.5 KB
references/marketplace.mdmarkdown11.5 KB
references/modes/compile-apm-package.mdmarkdown1.7 KB
references/modes/convert-plugin-to-apm.mdmarkdown7.3 KB
references/modes/create-apm-package.mdmarkdown1.7 KB
references/modes/install-apm-package.mdmarkdown4.3 KB
references/modes/manage-marketplace.mdmarkdown2.1 KB
requirements-dev.inother657 B
requirements-dev.txtmarkdown3.3 KB
requirements.inother148 B
requirements.txtmanifest171 B
scripts/apm_build_pipeline.pyscript35.1 KB
scripts/apm_consumer.pyscript11.3 KB
scripts/apply_symlink_repairs.pyscript1.7 KB
scripts/apply_symlink_repairs.shscript40 B
scripts/audit_marketplace_sources.pyscript2.5 KB
scripts/check_for_broken_symlinks.pyexecutablescript6.6 KB
scripts/convert_symlinks_to_manifest.pyscript6.7 KB
scripts/decouple_agent_paths.pyscript9.1 KB
scripts/fix_inside_plugin_symlinks.pyscript11.3 KB
scripts/materialize_copies.pyscript5.3 KB
scripts/migrate_to_apm.pyscript16.4 KB
scripts/scaffold_apm.pyscript8.6 KB
scripts/validate_apm_package.pyscript5.7 KB
tests/test_apm_build_pipeline.pyscript10.2 KB
tests/test_apm_consumer.pyscript4.8 KB
tests/test_audit_decoupled_state.pyscript8.6 KB
tests/test_convert_symlinks_to_manifest.pyscript5.3 KB
tests/test_decouple_agent_paths.pyscript4.8 KB
tests/test_scaffold_apm.pyscript1.7 KB

scripts/audit_marketplace_sources.py

View on GitHub
#!/usr/bin/env python3
"""
Purpose:
    Validates that every plugin entry in .claude-plugin/marketplace.json points to a
    directory that actually exists. Missing source paths cause silent install failures
    in the Claude Code /plugin UI with no actionable error message.

Key Input Dependencies:
    - .claude-plugin/marketplace.json (plugin registry with source paths)
    - Project root directory structure

Key Functions:
    - audit(): Validate marketplace.json source paths and return exit code
    - main(): CLI entry point

Usage:
    python audit_marketplace_sources.py [repo_root]
    python audit_marketplace_sources.py .
"""
import json
import sys
from pathlib import Path


def audit(repo_root: Path) -> int:
    """Validate all marketplace.json plugin entries have valid source paths; return exit code."""
    marketplace = repo_root / ".claude-plugin" / "marketplace.json"
    if not marketplace.exists():
        print(f"No marketplace.json found at {marketplace}")
        return 0

    try:
        with marketplace.open() as f:
            m = json.load(f)
    except json.JSONDecodeError as e:
        print(f"ERROR: marketplace.json is invalid JSON: {e}")
        return 1

    plugins = m.get("plugins", [])
    failures = []

    for p in plugins:
        name = p.get("name", "<unnamed>")
        source = p.get("source")
        if not isinstance(source, str) or not source.startswith("./"):
            continue  # non-relative sources (github, npm, url) can't be checked locally
        path = repo_root / source[2:]  # strip leading ./
        if not path.is_dir():
            failures.append((name, str(source), str(path)))

    if failures:
        print(f"Broken marketplace source paths ({len(failures)} of {len(plugins)}):\n")
        for name, source, path in failures:
            print(f"  MISS  {name:<40s}  {source}")
            print(f"        resolved to: {path}")
        print(
            "\nFix: update 'source' in marketplace.json to match the real directory name, "
            "or remove the entry."
        )
        return 1

    print(f"✓ All {len(plugins)} marketplace entries have valid source paths.")
    return 0


def main() -> None:
    """Parse CLI argument and audit marketplace.json source paths."""
    repo_root = Path(sys.argv[1]) if len(sys.argv) > 1 else Path(".")
    if not repo_root.is_dir():
        print(f"ERROR: Not a directory: {repo_root}")
        sys.exit(1)
    sys.exit(audit(repo_root.resolve()))


if __name__ == "__main__":
    main()
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