AAM — Agent Artifact Manager

The package manager for AI agent artifacts.

Package, share, and deploy skills, agents, prompts, and instructions across Cursor, Claude, GitHub Copilot, and more.

pip install "git+https://github.com/spazyCZ/agent-package-manager.git#subdirectory=apps/aam-cli"

Why AAM?

We know how to manage software dependencies with npm and pip. But when it comes to agentic development — prompts, skills, agent configurations, and instruction sets — the ecosystem is still fragmented.

AAM makes agent artifacts versionable, packageable, and shareable — just like software dependencies.

Status	Problem	Description
✅ Solved	Tracking distributed skills	Skills live across multiple repositories and providers. AAM's git sources workflow unifies discovery, versioning, and synchronization.
🔄 In progress	Packaging artifacts	Real use-cases combine skills, agent configs, and prompts. AAM packages them into reusable, shareable units.
🔄 In progress	Registry for agent artifacts	There's no `npm` for agent artifacts. AAM provides a registry to publish, discover, and install them.

flowchart TB
    subgraph Package["📦 Your AAM Package"]
        direction LR
        Skills["🛠️ Skills"]
        Agents["🤖 Agents"]
        Prompts["💬 Prompts"]
        Instructions["📋 Instructions"]
    end
    
    Package --> Cursor["<b>Cursor</b><br/>.cursor/"]
    Package --> Claude["<b>Claude</b><br/>CLAUDE.md"]
    Package --> Copilot["<b>Copilot</b><br/>.github/"]
    Package --> Codex["<b>Codex</b><br/>~/.codex/"]
    
    style Package fill:#e1f5fe,stroke:#01579b
    style Cursor fill:#fff3e0,stroke:#e65100
    style Claude fill:#fce4ec,stroke:#880e4f
    style Copilot fill:#e8f5e9,stroke:#1b5e20
    style Codex fill:#f3e5f5,stroke:#4a148c

Quick Start

1. Use remote skills

Set up default sources and fetch community skills:

aam init                    # First time: configure platform + default sources
aam source update --all     # Clone and scan upstream repositories
aam search python           # Search for skills
aam install code-reviewer   # Install a skill to your workspace

2. Create your own package

From an existing project (autodetect skills and agents):

cd my-project/
aam pkg create

# Scanning for artifacts not managed by AAM...
# Found 3 artifacts:
#   [x] 1. code-reviewer     .cursor/skills/code-reviewer/SKILL.md
#   [x] 2. security-auditor  .cursor/rules/agent-security-auditor.mdc
#   [x] 3. python-rules      .cursor/rules/python-rules.mdc
#
# ✓ Package created: my-project@1.0.0

From scratch:

mkdir my-awesome-skill && cd my-awesome-skill
aam pkg init

# ✓ Created my-awesome-skill/
#     ├── aam.yaml
#     ├── skills/
#     ├── prompts/
#     └── instructions/

Validate, pack, and publish:

aam pkg validate    # Check package is valid
aam pkg pack        # Build the archive
aam pkg publish     # Upload to registry

Default Skill Sources

On first run or when you run aam source enable-defaults, AAM registers 4 curated community repositories:

Source	Repository	Path
`github/awesome-copilot`	github/awesome-copilot	`skills`
`openai/skills:.curated`	openai/skills	`skills/.curated`
`anthropics/skills`	anthropics/skills	`skills`
`microsoft/skills`	microsoft/skills	`.github/skills`

After enabling defaults, run aam source update --all to clone and scan. Remove sources with aam source remove, re-enable with aam source enable-defaults.

AAM tracks and unifies skills from multiple community repositories:

flowchart LR
    subgraph Upstreams["📂 Upstream Sources"]
        direction TB
        A["github/awesome-copilot"]
        B["openai/skills"]
        C["anthropics/skills"]
        D["microsoft/skills"]
        Custom["+ Your own<br/>aam source add &lt;url&gt;"]
    end

    subgraph AAM["🔧 AAM"]
        Cache["~/.aam/sources-cache/"]
        Scan["Scan & Index"]
        Cache --> Scan
    end

    subgraph Deploy["📦 Your Workspace"]
        Cursor[".cursor/skills/"]
    end

    A -->|clone| Cache
    B -->|clone| Cache
    C -->|clone| Cache
    D -->|clone| Cache
    Custom -->|clone| Cache

    Scan -->|install| Cursor

    style Upstreams fill:#fff3e0,stroke:#e65100
    style Custom fill:#e8f5e9,stroke:#1b5e20
    style AAM fill:#e1f5fe,stroke:#01579b
    style Deploy fill:#e8f5e9,stroke:#1b5e20

MCP Server

AAM includes a built-in Model Context Protocol server, allowing IDE agents to interact with AAM directly — search packages, manage sources, install skills, and get recommendations without leaving the editor.

# Start read-only server (default, safe for any IDE)
aam mcp serve

# Enable write operations (install, publish, source management)
aam mcp serve --allow-write

IDE configuration (Cursor, Claude Desktop, Windsurf, VS Code):

{
  "mcpServers": {
    "aam": {
      "command": "aam",
      "args": ["mcp", "serve"]
    }
  }
}

The server exposes 29 tools and 9 resources:

Category	Read-only tools	Write tools (opt-in)
Packages	`search`, `list`, `info`, `validate`	`install`, `uninstall`, `publish`, `create_package`
Sources	`source_list`, `source_scan`, `source_candidates`, `source_diff`	`source_add`, `source_remove`, `source_update`
Config	`config_get`, `doctor`, `registry_list`	`config_set`, `registry_add`, `init`
Discovery	`recommend_skills`, `available`, `outdated`	`upgrade`, `init_package`
Integrity	`verify`, `diff`	—

Options:

Flag	Description
`--transport`	`stdio` (default) or `http`
`--port PORT`	HTTP port (default: `8000`, HTTP transport only)
`--allow-write`	Enable write tools (install, publish, source management). Without this flag, only read-only tools are available.
`--log-file PATH`	Log to file instead of stderr
`--log-level`	`DEBUG`, `INFO`, `WARNING`, `ERROR`

Features

One package, all platforms — Write once, deploy to Cursor, Claude, GitHub Copilot, and Codex
Dependency management — Declare dependencies, AAM resolves them automatically
Local & centralized registries — Work offline or share with the community
Package signing — Sigstore (keyless) and GPG signature support
MCP server — IDE agents can use AAM tools directly via Model Context Protocol
Simple CLI — Intuitive commands: init, install, pkg publish, source

CLI Commands

Using skills from source

Command	Description
`aam init`	Set up AAM (platform, default sources)
`aam install <pkg>`	Install a package and dependencies
`aam uninstall <pkg>`	Remove an installed package
`aam upgrade`	Update packages to latest compatible versions
`aam list`	List installed packages
`aam search <query>`	Search registry and sources for packages
`aam info <pkg>`	Show package details
`aam source`	Manage git artifact sources (add, list, update, remove)
`aam registry`	Manage registries (init, add, list)
`aam config`	Manage configuration

Package authoring (pkg)

Command	Description
`aam pkg create`	Create package from existing project (autodetect + interactive)
`aam pkg init`	Create a new package from scratch (interactive)
`aam pkg validate`	Validate package manifest and artifacts
`aam pkg pack`	Build distributable `.aam` archive
`aam pkg publish`	Publish package to registry

Package Structure

my-package/
├── aam.yaml                    # Package manifest (required)
├── agents/                     # Agent definitions
│   └── my-agent/
│       ├── agent.yaml
│       └── system-prompt.md
├── skills/                     # Skills
│   └── my-skill/
│       └── SKILL.md
├── prompts/                    # Prompt templates
│   └── my-prompt.md
└── instructions/               # Platform rules
    └── coding-standards.md

Package Manifest (`aam.yaml`)

name: my-package
version: 1.0.0
description: "My awesome AI agent package"
author: your-username
license: Apache-2.0

artifacts:
  skills:
    - name: my-skill
      path: skills/my-skill/
      description: "Does something useful"
  prompts:
    - name: my-prompt
      path: prompts/my-prompt.md

dependencies:
  common-utils: "^1.0.0"

platforms:
  cursor:
    skill_scope: project
  claude:
    merge_instructions: true

Platform Support

AAM automatically deploys artifacts to the correct locations for each platform:

Platform	Skills	Agents	Prompts	Instructions
Cursor	`.cursor/skills/`	`.cursor/rules/`	`.cursor/prompts/`	`.cursor/rules/`
Claude	`.claude/skills/`	`.claude/agents/`	`.claude/prompts/`	`CLAUDE.md`
Copilot	`.github/skills/`	`.github/agents/`	`.github/prompts/`	`.github/instructions/`
Codex	`~/.codex/skills/`	`AGENTS.md`	`~/.codex/prompts/`	`AGENTS.md`

Configuration

Global Configuration (`~/.aam/config.yaml`)

default_platform: cursor

active_platforms:
  - cursor
  - claude

registries:
  - name: aam-central
    url: https://registry.aam.dev
    type: http

security:
  require_signature: false
  on_unsigned: warn

Project Configuration (`.aam/config.yaml`)

default_platform: cursor

platforms:
  cursor:
    skill_scope: project

Documentation

User Guide — Complete walkthrough with examples
Design Document — Architecture and technical details
HTTP Registry Spec — API specification for registry service

Contributing

Contributions welcome! See CONTRIBUTING.md for development setup and guidelines.

License

Apache License 2.0 — see LICENSE for details.

Built for the AI agent ecosystem.
Package once. Deploy everywhere.

Name		Name	Last commit message	Last commit date
Latest commit History 69 Commits
.github/workflows		.github/workflows
apps		apps
docs		docs
specs		specs
.dockerignore		.dockerignore
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc		.prettierrc
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
eslint.config.mjs		eslint.config.mjs
nx.json		nx.json
package-lock.json		package-lock.json
package.json		package.json
tsconfig.base.json		tsconfig.base.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

AAM — Agent Artifact Manager

Why AAM?

Quick Start

1. Use remote skills

2. Create your own package

Default Skill Sources

MCP Server

Features

CLI Commands

Using skills from source

Package authoring (pkg)

Package Structure

Package Manifest (`aam.yaml`)

Platform Support

Configuration

Global Configuration (`~/.aam/config.yaml`)

Project Configuration (`.aam/config.yaml`)

Documentation

Contributing

License

About

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

AAM — Agent Artifact Manager

Why AAM?

Quick Start

1. Use remote skills

2. Create your own package

Default Skill Sources

MCP Server

Features

CLI Commands

Using skills from source

Package authoring (pkg)

Package Structure

Package Manifest (aam.yaml)

Platform Support

Configuration

Global Configuration (~/.aam/config.yaml)

Project Configuration (.aam/config.yaml)

Documentation

Contributing

License

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Contributors

Uh oh!

Languages

Package Manifest (`aam.yaml`)

Global Configuration (`~/.aam/config.yaml`)

Project Configuration (`.aam/config.yaml`)