ai-tools

AI Agents

A collection of Agent Skills for managing media libraries, downloading content, and automating workflows. Skills follow the open Agent Skills specification and work with any compatible AI coding agent.

Skills

Skill	Description
audiobooks	Manage audiobook libraries, download covers, embed metadata, search AudiobookBay
audiobookshelf	Audiobookshelf server API — libraries, metadata, authors, rescans
copilot-sdk	GitHub Copilot SDK — programmatically call Copilot from Python
ebook	EPUB metadata extraction, updates, cover embedding, series info
jellyfin	Jellyfin server API — libraries, search, metadata, rescans
kavita	Kavita reading server API — libraries, series, metadata, rescans
libgen	Search and download ebooks from Library Genesis
nyaa	Search and download anime torrents from nyaa.si
plex	Plex Media Server API — libraries, search, playlists, collections
qbittorrent	qBittorrent client — add, pause, resume, delete torrents
yify	Search and download movie torrents from YTS/YIFY

Quick Start

Prerequisites

• Python 3.13+
• uv package manager

Installation

git clone https://github.com/hevangel/ai_agents.git
cd ai_agents
uv sync

Configuration

cp .env.example .env
# Edit .env with your actual credentials and paths

See .env.example for all available settings.

Usage

With Claude Code

Register this repo as a plugin marketplace:

/plugin marketplace add hevangel/ai_agents

Then install skill groups:

/plugin install media-server-skills@ai-agents-skills
/plugin install torrent-skills@ai-agents-skills
/plugin install ebook-skills@ai-agents-skills
/plugin install audiobook-skills@ai-agents-skills
/plugin install ai-tools@ai-agents-skills

With VS Code Copilot

Skills in skills/ are automatically discovered when the repo is open as a workspace. Reference a skill by mentioning it in chat, or use #<skill-name>.

With Other Agent Tools

Any tool supporting the Agent Skills specification can use these skills. Point the tool at the skills/ directory.

Running Scripts Directly

# Run any skill script
uv run python skills/<skill>/scripts/<script>.py

# Example: search Jellyfin
uv run python skills/jellyfin/scripts/search_media.py "Gundam" Movie

# Example: list Plex libraries
uv run python skills/plex/scripts/list_libraries.py

Project Structure

skills/                  # Agent skills (agentskills.io format)
  <skill-name>/
    SKILL.md             # Metadata + instructions
    scripts/             # Code snippets and modules
.claude-plugin/          # Claude Code marketplace config
mcp_servers/             # MCP server implementations
anime_organizer/         # Anime library organizer
anime_database/          # Anime metadata (MongoDB)
temp/                    # Temporary files (gitignored)

Updating AI CLI Tools

# Windows
.\update_agents.ps1

# Linux / macOS
./update_agents.sh

Cross-Platform Support

• All Python code uses pathlib.Path for cross-platform path handling
• Shell scripts provided for both Windows (PowerShell) and Linux/macOS (Bash)
• Library paths configured via environment variables (no hardcoded OS-specific paths)

License

MIT