Aspm

aspm - AI Skill Package Manager

A Git-based package manager designed for AI-assisted development, similar to npm but supporting skills, agents, commands, hooks, and any AI resource types.

Features

• 📦 Two Project Modes: Publish project (aspub.yaml) and consumer project (aspkg.yaml)
• 🔗 Distributed Dependency Management: Reference packages directly via Git URL, no central registry needed
• 🏷️ Flexible Version Control: Support for Git tag/branch/commit
• 📥 Simplified Version Rules: Auto-selects the maximum version satisfying all dependencies
• 🔧 Universal Design: Not limited to skills, supports any AI resource type
• 🔌 Multi-Format Support: Install both aspm packages and Claude Code plugin repositories
• 🎯 Three Install Modes: Plain, Claude, and Compatible modes for different AI tool directory structures

Installation

Quick Install

**Linux / macOS:**

curl -fsSL https://raw.githubusercontent.com/arkylab/aspm/main/scripts/install.sh | sh

**Windows (PowerShell):**

irm https://raw.githubusercontent.com/arkylab/aspm/main/scripts/install.ps1 | iex

Build from Source

git clone https://github.com/arkylab/aspm.git
cd aspm
cargo build --release

The compiled binary will be at `target/release/aspm` (or `aspm.exe` on Windows).

Quick Start

Creating a Consumer Project (If you are a skill consumer)

# Initialize a consumer project
aspm init --consumer

# This creates aspkg.yaml

Configure aspkg.yaml

# Installation target directory
install_to: 
  - .claude    # Install to Claude Code plugin directory

dependencies:
  superpowers:
    git: "https://github.com/obra/superpowers.git"
    branch: "main"

Install Dependencies

aspm install
# After running `aspm install`, all dependencies are ready. If you are using Claude Code, you can now restart Claude code to load the new skills. Sometimes, you may need to restart it twice.

**✅