This repo contains the v0.2.0 skill/rule conversion engine and is preparing the v0.3.0 MCP engine.
README.md Current capabilities, setup, usage, architecture, and v1 promise
AGENTS.md Codex project instructions and safety rules
NEXT_STEPS.md Concrete implementation tasks for v0.3.0
V1_PLAN.md Authoritative v0.3.0 through v1.0.0 release plan
CODEX_HANDOFF.md Short handoff file for opening the repo in Codex
ROADMAP.md Concise version-level summary linked to V1_PLAN.md
CHANGELOG.md Version history
MANIFEST.md This file
docs/ Schema, compatibility, security, release, and implementation docs
src/agent_portability_kit/
├── __init__.py
├── __main__.py
├── cli.py CLI entrypoint for apk
├── models.py Portable intermediate representation
├── scan.py Source asset discovery
├── classify.py Artifact classification
├── planner.py Conversion plan builder
├── validate.py Plan/output validation
├── writer.py Safe writer and audit output
├── report.py Human-readable reports
├── adapters/ Platform-specific edge behavior
├── emitters/ Codex/Cline/neutral emitters
├── importers/ Source-specific importers; Codex/Cline MCP importers are next
├── schemas/ JSON schema files for portable objects
└── utils/ Shared helpers
skills/agent-portability-kit/
├── SKILL.md
├── agents/openai.yaml
├── scripts/apk.py
└── references/
.codex-plugin/plugin.json
legacy/export_skills.py
legacy/mcp_envkit.py
These are preserved as historical engines/reference implementations. New development should happen under src/agent_portability_kit/ unless a legacy script is being deliberately migrated.
tests/fixtures/ Cross-platform test projects
tests/test_scan_convert.py Smoke tests for scan/convert/write flows
Run:
python -m compileall -q src tests
python -m unittest discover -s tests -v