Metadata-Version: 2.4
Name: pipx-skills
Version: 0.1.0
Summary: Python-native skill installer for Hermes/OpenClaw agents
Project-URL: Homepage, https://github.com/eddieoz/pipx-skills
Project-URL: Repository, https://github.com/eddieoz/pipx-skills
Project-URL: Bug Tracker, https://github.com/eddieoz/pipx-skills/issues
Author-email: eddieoz <eddieoz@pm.me>
License: MIT
License-File: LICENSE
Keywords: agent-skills,ai-agent,clawhub,hermes,lightning,nostr,nwc,openclaw,skills
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# pipx-skills

Python-native skill installer for [Hermes Agent](https://hermes-agent.nousresearch.com/) and OpenClaw.

This is the **pure Python equivalent** of `npx skills add` but without requiring Node.js. It installs skills to `~/.agents/skills/` by default (universal location that works with any agent framework).

## Installation

### Using pipx (recommended)
```bash
pipx install git+https://github.com/eddieoz/pipx-skills.git
```

### Using pip
```bash
pip install git+https://github.com/eddieoz/pipx-skills.git
```

### Using uv (fastest)
```bash
uv pip install git+https://github.com/eddieoz/pipx-skills.git
```

### One-liner (no install)
```bash
python3 -c "$(curl -fsSL https://raw.githubusercontent.com/eddieoz/pipx-skills/main/src/pipx_skills/__init__.py)" -- add eddieoz/nwc-agent
```

## Usage

```bash
# Install a skill
pipx-skills add eddieoz/nwc-agent

# Install specific version
pipx-skills add eddieoz/nwc-agent --version v1.5.0

# Reinstall/force update
pipx-skills add eddieoz/nwc-agent --force

# List installed skills
pipx-skills list

# Remove a skill
pipx-skills remove nwc-agent
```

## Comparison with npx

| Feature | `npx skills add` | `pipx-skills add` |
|---------|------------------|-------------------|
| Requires Node.js | Yes | **No** |
| Installs to | `~/.openclaw/skills/` | `~/.agents/skills/` (universal) |
| Works with | OpenClaw | Hermes, OpenClaw, any agent |
| Pure Python | No | **Yes** |
| Works on RISC-V | No | **Yes** |

## How It Works

1. Parses `owner/repo` from the skill ID
2. Fetches metadata from `SKILL.md` on GitHub
3. Clones the repository to the skills directory
4. Installs Python dependencies from `requirements.txt`
5. Removes `.git` directory to save space
6. The skill is now available in Hermes/OpenClaw

## Environment Variables

- `HERMES_SKILLS_DIR` - Override the default skills directory

## Requirements

- Python 3.8+
- Git
- Internet connection

## Author

Created by [eddieoz](https://github.com/eddieoz) for the pure Python agent ecosystem.
