JSPM

@permamind/skills

1.0.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 214
  • Score
    100M100P100Q73770F
  • License MIT

CLI tool for publishing, searching, and installing Claude Agent Skills

Package Exports

  • @permamind/skills
  • @permamind/skills/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@permamind/skills) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@permamind/skills

npm version License: MIT Node.js Version

A decentralized CLI for publishing, searching, and installing Claude Agent Skills on Arweave and AO networks.

Overview

The Agent Skills Registry enables developers to:

  • Publish Claude Agent Skills as immutable bundles on Arweave
  • Search for Skills via a decentralized AO registry process
  • Install Skills with automatic dependency resolution

Installation

npm install -g @permamind/skills

Verify installation:

skills --version

Prerequisites

  • Node.js: 20.11.0 LTS or higher
  • npm: 10.x or higher (bundled with Node.js)
  • Arweave Wallet: Required for publishing Skills (JSON keyfile)

Quick Start

1. Configure Your Wallet

Create a .skillsrc file in your home directory:

{
  "wallet": "~/.arweave/wallet.json",
  "registry": "AO_REGISTRY_PROCESS_ID",
  "gateway": "https://arweave.net"
}

2. Search for Skills

# Search by keyword
skills search arweave

# List all skills
skills search ""

# Filter by tags
skills search --tag tutorial --tag beginner

3. Install a Skill

# Install globally (default)
skills install ao-basics

# Install to project directory
skills install ao-basics --local

4. Publish a Skill

# Publish a skill directory
skills publish ./my-skill

# With verbose logging
skills publish ./my-skill --verbose

Commands

skills search [query]

Search for Skills in the decentralized registry.

Options:

  • --tag <tag> - Filter by tag (can be repeated)
  • --author <address> - Filter by author Arweave address
  • --limit <number> - Limit number of results (default: 20)

Examples:

skills search "arweave basics"
skills search --tag tutorial --tag beginner
skills search --author ABC123...XYZ789

skills install <name>

Install a Skill with automatic dependency resolution.

Options:

  • --local - Install to project directory instead of global
  • --force - Force reinstall even if already installed
  • --skip-deps - Skip dependency installation

Examples:

skills install ao-basics
skills install my-skill --local
skills install advanced-skill --force

skills publish <directory>

Publish a Skill to Arweave and register it in the AO registry.

Options:

  • --verbose - Show detailed logging
  • --dry-run - Validate without publishing
  • --wallet <path> - Override wallet path from config

Examples:

skills publish ./my-skill
skills publish ./my-skill --verbose
skills publish ./my-skill --dry-run

skills --help

Display help for all commands or a specific command.

skills --help
skills publish --help
skills search --help

Architecture

This CLI uses a decentralized infrastructure:

  • Arweave Network: Permanent storage for skill bundles (.tar.gz files)
  • AO Network: Decentralized compute for registry process (Lua handlers)
  • npm Registry: CLI tool distribution

Troubleshooting

"command not found: skills"

Ensure npm global bin directory is in your PATH:

# Check npm global bin path
npm bin -g

# Add to PATH (example for macOS/Linux with bash)
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.bashrc
source ~/.bashrc

"Permission denied" on installation

Use Node Version Manager (nvm) to avoid permission issues:

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Install Node.js via nvm
nvm install 20.11.0
nvm use 20.11.0

# Install CLI globally (no sudo needed)
npm install -g @permamind/skills

"Wallet not found"

Create a .skillsrc config file with your wallet path:

{
  "wallet": "/path/to/your/arweave-wallet.json"
}

Or generate a new Arweave wallet:

Contributing

Contributions are welcome! Please see the GitHub repository for:

  • Source code
  • Issue tracker
  • Contributing guidelines
  • Development setup

License

MIT License - See LICENSE for details.

Support

For questions, issues, or feature requests:

Built with ❤️ on Arweave and AO networks