Skip to content

Tutorials

Welcome to the AAM tutorials! These hands-on guides walk you through real-world scenarios, from packaging your first project to advanced dependency management and multi-platform deployment.

How to Use These Tutorials

Each tutorial is self-contained and can be completed independently. They range from beginner to advanced, with estimated completion times to help you plan your learning path.

All tutorials include:

  • Real-world scenarios that solve practical problems
  • Step-by-step commands with expected output
  • Full working examples you can copy and paste
  • Clear explanations of what's happening at each step

New to AAM?

Start with Packaging Existing Skills to learn the basics, then move on to Building a Code Review Package for a complete end-to-end example.

Available Tutorials

  • Packaging Existing Skills {#packaging-existing-skills}

    Learn how to use aam pkg create to bundle skills, agents, and instructions from an existing project.

    Difficulty: Beginner Time: 10 minutes

    Start tutorial

  • Building a Code Review Package {#building-a-code-review-package}

    Build a complete security review toolkit from scratch with skills, agents, prompts, instructions, and tests.

    Difficulty: Intermediate Time: 25 minutes

    Start tutorial

  • Sharing with Your Team

    Set up local registries for team sharing via shared filesystems, Git repositories, or cloud storage.

    Difficulty: Beginner Time: 15 minutes

    Start tutorial

  • Multi-Platform Deployment

    Configure simultaneous deployment to Cursor, Claude Desktop, and GitHub Copilot with a single install command.

    Difficulty: Intermediate Time: 15 minutes

    Start tutorial

  • Working with Dependencies

    Master dependency constraints, lock files, transitive dependencies, and conflict resolution.

    Difficulty: Intermediate Time: 20 minutes

    Start tutorial

What You'll Need

Before starting the tutorials, make sure you have:

  • AAM installed - See the Installation Guide
  • Basic command line knowledge - Familiarity with running terminal commands
  • A text editor - For editing YAML and Markdown files

Some tutorials have additional prerequisites, which are listed at the start of each guide.

After the Tutorials

Once you've completed these tutorials, you'll be ready to:

  • Package your own skills and agents for distribution
  • Set up a team registry for sharing artifacts
  • Deploy packages across multiple AI platforms
  • Manage complex dependency relationships
  • Build production-ready agent packages

For deeper dives into specific topics, check out:

Getting Help

If you run into issues while following these tutorials:

  1. Check the Troubleshooting Guide
  2. Run aam doctor to diagnose common problems
  3. Review the relevant CLI reference for command details
  4. Ask in the GitHub Discussions

Happy learning!