Agent Skills

This repository contains high-quality skills for AI agents, following the Agent Skills standard.

Installation

Add these skills to your agent using the Skills CLI:

npx skills add azzgo/agent-skills

Alternatively, you can install by manually copying the specific skill folder into your agent's skills directory.

Available Skills

aria2-json-rpc

A comprehensive skill to control the aria2 download manager via JSON-RPC.

Key Features:

• Download Management: Add HTTP/HTTPS/FTP, Magnet, Torrent, and Metalink downloads.
• Control: Pause, resume, and remove individual or all downloads.
• Monitoring: List active, waiting, and stopped downloads; view global stats and progress.
• Zero Dependencies: Core functionality uses standard libraries (no heavy pip installs required).
• Secure: Supports token-based authentication and secure connections.

Prerequisites

1. aria2c Daemon: You need aria2c running with RPC enabled.
2. Network Access: The agent needs access to the RPC port.
3. WebSocket Support (Optional): If using WebSocket connections, ensure Python version matches the requirements of the websockets package.

Quick Start (Local):

aria2c --enable-rpc --rpc-listen-all=false --rpc-listen-port=6800

With Secret Token:

aria2c --enable-rpc --rpc-secret="YOUR_TOKEN" --rpc-listen-all=false --rpc-listen-port=6800

Configuration

The skill works out-of-the-box with default settings (localhost:6800). For custom configurations, the skill supports multiple configuration sources with the following priority:

Priority (highest to lowest):

1. Environment variables (temporary override)
2. Skill directory config (project-specific)
3. User config directory (global, update-safe) 🆕
4. Defaults

Recommended Setup (Update-Safe):

Initialize user configuration that survives skill updates:

# Navigate to the skill directory
cd skills/aria2-json-rpc

# Initialize user config
python3 scripts/config_loader.py init --user

# Edit the config file
nano ~/.config/aria2-skill/config.json

Example configuration:

{
  "host": "localhost",
  "port": 6800,
  "secret": "YOUR_TOKEN",
  "secure": false,
  "timeout": 30000
}

Alternative: Project-Specific Config

For testing or project-specific settings (⚠️ lost on updates):

cd skills/aria2-json-rpc
python3 scripts/config_loader.py init --local
# Edit skills/aria2-json-rpc/config.json

Alternative: Environment Variables

For temporary overrides or CI/CD:

export ARIA2_RPC_HOST="localhost"
export ARIA2_RPC_PORT=6800
export ARIA2_RPC_SECRET="YOUR_TOKEN"

Configuration Management:

# Show current configuration
python3 scripts/config_loader.py show

# Test connection
python3 scripts/config_loader.py test

---

For Developers

Repository Structure

skills/
  aria2-json-rpc/         # The skill source code
    SKILL.md              # Definition
    scripts/              # Python implementation
    tests/                # Tests

Development Requirements

• Python 3.6+
• Just (command runner)
• UV (optional, for dependency management)

Running Tests

# Run all tests
just test

# Run specific test file
just test-file tests/unit/test_rpc_client.py

License

MIT (see LICENSE).