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

tests/test_decouple_agent_paths.py

View on GitHub
#!/usr/bin/env python3
"""
Unit tests for decouple_agent_paths.py (convert-plugin-to-apm skill).

Purpose:
    Validates the install-folder reference rewriter (APM migration plan Section 6.2):
    1. R1/R2 rewrite a skill's own `.agents/skills/<self>/...` paths to skill-relative paths
    2. R3 rewrites links and bare paths to another skill's SKILL.md into a name reference
    3. Fenced code, commands inside inline code, and JSON values are left untouched
    4. Excluded files (legacy installer, ledgers, ignore files) are never scanned
    5. Dry-run writes nothing; --apply writes only the rewrites

Key Input Dependencies:
    - ../scripts/decouple_agent_paths.py (module under test)
    - git on PATH
"""

import subprocess
import sys
import tempfile
import unittest
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "scripts"))
import decouple_agent_paths as decouple  # noqa: E402


class TestRewriteText(unittest.TestCase):
    """rewrite_text on in-memory markdown."""

    def test_own_skill_script_and_file(self) -> None:
        text = "Run `python3 .agents/skills/me/scripts/run.py` and read .agents/skills/me/references/a.md."
        new, changes = decouple.rewrite_text(text, "me")
        self.assertIn("`python3 .agents/skills/me/scripts/run.py`", new)  # command span untouched
        self.assertIn("read references/a.md.", new)
        self.assertEqual([c["rule"] for c in changes], ["R2"])

    def test_own_skill_whole_span_path(self) -> None:
        new, changes = decouple.rewrite_text("See `.agents/skills/me/scripts/run.py`.", "me")
        self.assertEqual(new, "See `scripts/run.py`.")
        self.assertEqual(changes[0]["rule"], "R1")

    def test_other_skill_link_and_bare_path(self) -> None:
        text = "Use [ADR tool](.agents/skills/adr-management/SKILL.md). Details: `.agents/skills/dep/SKILL.md`"
        new, changes = decouple.rewrite_text(text, None)
        self.assertEqual(new, "Use ADR tool (the `adr-management` skill). Details: the `dep` skill")
        self.assertEqual(len(changes), 2)

    def test_code_and_data_left_alone(self) -> None:
        text = ("```bash\npython3 .agents/skills/x/scripts/y.py\n```\n"
                '"source_file": ".agents/skills/x/SKILL.md"\n'
                "`python scripts/e.py --skill .agents/skills/x/SKILL.md`\n"
                "`./Other/.agents/skills/x/SKILL.md`\n")
        new, changes = decouple.rewrite_text(text, "x")
        self.assertEqual(new.count(".agents/skills/x/"), 4 - sum(1 for c in changes))
        self.assertIn("python3 .agents/skills/x/scripts/y.py", new)
        self.assertIn("--skill .agents/skills/x/SKILL.md", new)
        self.assertIn("./Other/.agents/skills/x/SKILL.md", new)


class TestScan(unittest.TestCase):
    """scan() over a temporary git repository."""

    def setUp(self) -> None:
        self.tmp = tempfile.TemporaryDirectory()
        self.root = Path(self.tmp.name)
        files = {
            "plugins/p/skills/me/SKILL.md": "Read .agents/skills/me/references/a.md and .agents/skills/other/SKILL.md\n",
            "plugins/p/rules/r.md": "Full workflow details -> `.agents/skills/me/SKILL.md`\n",
            "plugins/plugin-manager/README.md": "Installs into .agents/skills/me/SKILL.md\n",
            "references/map-debt.md": "Old: .agents/skills/me/SKILL.md\n",
            ".claudeignore": ".agents/\n",
        }
        for rel, body in files.items():
            (self.root / rel).parent.mkdir(parents=True, exist_ok=True)
            (self.root / rel).write_text(body)
        subprocess.run(["git", "init", "-q"], cwd=self.root, check=True)
        subprocess.run(["git", "add", "-A"], cwd=self.root, check=True)

    def tearDown(self) -> None:
        self.tmp.cleanup()

    def test_dry_run_reports_without_writing(self) -> None:
        before = (self.root / "plugins/p/skills/me/SKILL.md").read_text()
        result = decouple.scan(self.root, apply=False)
        self.assertEqual(sorted(c["file"] for c in result["changed_files"]),
                         ["plugins/p/rules/r.md", "plugins/p/skills/me/SKILL.md"])
        self.assertEqual((self.root / "plugins/p/skills/me/SKILL.md").read_text(), before)

    def test_apply_writes_and_skips_excluded(self) -> None:
        decouple.scan(self.root, apply=True)
        self.assertEqual((self.root / "plugins/p/skills/me/SKILL.md").read_text(),
                         "Read references/a.md and the `other` skill\n")
        self.assertEqual((self.root / "plugins/p/rules/r.md").read_text(), "Full workflow details -> the `me` skill\n")
        self.assertIn(".agents/", (self.root / "plugins/plugin-manager/README.md").read_text())
        self.assertIn(".agents/", (self.root / "references/map-debt.md").read_text())
        self.assertEqual((self.root / ".claudeignore").read_text(), ".agents/\n")


if __name__ == "__main__":
    unittest.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