UAAPS — Universal Agentic Artifact Package Specification¶
Write once. Deploy to any agent platform.
UAAPS is the open standard for packaging AI agent artifacts — analogous to Docker for containers or npm for JavaScript packages. A single package works across Claude Code, GitHub Copilot, Cursor, OpenAI Codex, and any compliant platform.
Why UAAPS?¶
| Problem | UAAPS Solution |
|---|---|
| Skills written for Claude Code can't be used in Copilot | Portable — one package, all platforms |
| No lock file to reproduce agent behavior in CI | Reproducible — package.agent.lock pins exact versions |
| Multiple packages cause silent instruction conflicts | Composable — namespaced skills prevent collisions |
No hooks for pre-tool-use or permission-request |
Lifecycle hooks — 10 unified events |
| No way to propagate skill updates across projects | Registry — versioned distribution with the aam CLI |
| No standard way to verify skills and hooks work correctly | Testable — deterministic tests/ + LLM-judged evals/ |
Quick Navigation¶
- Full Specification — Complete specification in a single document
- Introduction & Principles — Design goals and core principles
- Package Manifest —
package.agent.jsonschema reference - Skills — The primary portable artifact
- Hooks — Lifecycle event handlers
- Dependency Resolution — Lock files and version resolution
- Compatibility Matrix — Platform support at a glance
- Migration Guides — Migrating from Claude Code, Cursor, or Copilot
- Implementers Guide — Getting started as a platform implementer
Current Version¶
0.6.0-draft — See the Changelog for version history.
Contributing¶
- Read the specification
- Open an issue with feedback, edge cases, or missing scenarios
- Submit a PR with spec improvements or examples
- Test the Skills Concentrator