mop-skills/AGENTS.md

MOP Skills 🐙

This repository contains a collection of specialized Claude Skills. These skills extend Claude's capabilities with domain-specific knowledge, workflows, and automated reporting.

Repository Structure

.
├── AGENTS.md           # This file (purpose and overview)
├── skills/             # Dedicated directory for individual skills
│   ├── nerd-report/    # Personal report generator for Moritz Graf
│   ├── rvv-regensburg/ # Real-time public transport for Regensburg
│   └── skill-creator/  # Toolkit for creating and validating new skills

Available Skills

nerd-report

A professional "Octobot Journalist" that generates daily, weekly, and monthly reports for Moritz Graf.

• Topics: IT News, GCP, AI (Anthropic/OpenAI), Hacker News, Regensburg Local News.
• Special Features: Monday catch-up, Drill-down ("Tell me more"), Gardening (Hochbeet), Supermarket Shopping Guide.

memobird

Direct printing to the Memobird thermal printer. Allows sending text, images, and notes to the device on the local network.

• Features: Text styling (big, bold, underline), automated 1-bit image conversion, separator lines.
• Target: Default targets the static IP 192.168.10.165.

rvv-regensburg

Real-time public transport information for Regensburg (RVV). Provides departures, stop finding, and journey planning via direct API access.

• Features: Real-time departures with delay info, connection search, Stop ID resolver.
• Tools: Includes rvv_query.py for direct EFA API interaction.

text-to-audio

Audio dossier and podcast producer. Converts arbitrary research, summaries, notes, or articles into audio dossiers with duration target, importance compression, and solo or NotebookLM-style dialogue.

• Features: Target duration pacing (~130 words/min), importance filtering, solo monologue or multi-speaker dialogue.
• Voices: Primary Google Gemini 3.1 Flash TTS with automatic MiniMax Speech 02 HD fallback. German voices (Puck host/solo, Aoede co-host, Charon deep), English voices (Zephyr host/solo, Aoede co-host).
• Tools: Includes scripts/text_to_audio.py for parallel chunk synthesis, auto-fallback, and MP3 generation.

jelly-media

Seamless Jellyfin and Jellyseerr integration. Enables natural-language discovery, stream & download URLs, living room playback dispatch, continue watching, and media requests.

• Features: Smart search cross-referenced with library availability, discover with genre & rating filters, direct stream & download links, Jellyfin active sessions & remote play, Jellyseerr requests.
• Tools: Standalone MCP server and CLI at scripts/jelly_media.py.

shopping

Smart shopping advisor and Vorrats-Concierge.

• Features: German supermarket & discounter weekly discounts (Edeka, Rewe, Aldi, Lidl, Kaufland, Netto, Penny, dm, Rossmann), Vorratskauf multi-brand comparison (Mutti / Oro di Parma), diaper piece-price calculator (ct/Windel), Geizhals price comparison & all-time-low price history, and eBay marketplace search.
• Tools: Standalone MCP servers and CLIs at scripts/supermarket_deals.py, scripts/geizhals_mcp.py, and scripts/ebay_mcp.py.

spotify

Spotify music intelligence, catalog search, playback control, playlist curation, party queueing, and personal listening history.

• Features: 35+ tools via mcp-server-spotify (search, playlists, player/queue, listening stats, top items).
• Synergy: Bridges Spotify search with Home Assistant to stream Spotify URIs directly on Sonos multi-room speakers and sync Philips Hue lighting.
• Tools: Includes one-time token generator scripts/spotify_auth.py.

markitdown

Universal document and media converter powered by Microsoft MarkItDown.

• Features: Converts PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), HTML, CSV, audio, and images to clean Markdown.
• Tools: Standalone CLI and URL downloader at scripts/convert_to_markdown.py.

regensburg-stadtrat

Municipal politics, city council resolutions, meeting agendas, and Ratsinformation for the City of Regensburg (ALLRIS net).

• Features: Live Latin-1 full-text search across 20+ years of council records, native XML calendar and agenda feeds, Vorlagen metadata & verbatim resolution extraction, and compilation into the Obsidian knowledge vault.
• Tools: Includes scripts/regensburg_ris.py with search, calendar, session, vorlage, and compile-topic commands.

google-calendar

Two-way Google Calendar integration for Family Appointments and Regensburg Local Events via GCP Service Account.

• Features: Read, search, create, update, and delete events across two distinct calendars (family and regensburg).
• Tools: Standalone MCP server and CLI at scripts/google_calendar.py (calendar_list_events, calendar_create_event, calendar_update_event, calendar_delete_event, calendar_get_event).

hosting

Public S3 file sharing and static website hosting on https://hosting.haumdaucher.de.

• Features: Upload HTML research dossiers, recipes, documents, and images with clean URLs (/{category}/{YYYYMMDD}-{slug}.{ext}).
• Workflow: Proactively triggers ask_user with Telegram inline buttons to offer generating a branded QR code for the public link.
• Tools: Standalone publisher CLI at scripts/publish_file.py.

qr-code

Universal QR code generator featuring the Haumdaucher logo in the center.

• Features: High-redundancy QR code synthesis (ERROR_CORRECT_H), logo overlay with clean white badge, and native Telegram image delivery via MEDIA:<path>.
• Tools: Standalone CLI at scripts/generate_qr.py.

chart-to-chat

Instant chart and diagram generation for chat and Telegram.

• Features: Transforms structured data (JSON, CSV, key-value metrics) into publication-grade PNG diagrams (bar, line, area, donut, KPI cards, tables) powered by dbt-charts (dct) with QuickChart.io fallback.
• Delivery: Generates local PNGs and outputs MEDIA:<path> for native Telegram image rendering.
• Tools: Standalone CLI at scripts/chart.py.

create-website

Creative Web Director and Senior Frontend Engineer for single-page applications and interactive showcases.

• Features: Builds fancy, responsive, zero-build SPAs (Tailwind CSS Play CDN, Alpine.js reactivity, Lucide icons, Google Fonts) with anti-AI-slop design archetypes (Dark Obsidian, Editorial Warmth, Neo-Brutalism, Modern Clean SaaS).
• Hosting: Direct validation and upload to https://hosting.haumdaucher.de/showcase/... via the hosting skill pipeline, with native Telegram document delivery and QR code generation.
• Tools: Standalone validation & publisher CLI at scripts/publish_website.py.

grill-me

Relentless, structured interview to stress-test and sharpen plans, architectures, decisions, or ideas before writing code.

• Features: Decision tree & frontier exploration, Telegram/mobile-optimized batching (1-3 questions per round), facts-first environment research, anti-sycophancy challenge, and final specification/ADR synthesis.

zwift-workout

Builds, previews, validates and publishes Zwift .zwo workout files (bike-only).

• Workflow: draft JSON spec -> human-readable preview -> user confirms -> publish via hosting -> file into Knowledge Wiki.
• Features: Step types Warmup/Cooldown/SteadyState/Ramp/IntervalsT/FreeRide/MaxEffort/SolidState; power as FTP fractions; guardrails (0.20-1.50 FTP, XML escaping, round-trip parse check); TSS/duration estimate; templates (endurance, sweetspot, vo2max, sprint).
• Tools: CLI at scripts/zwo.py (build, from-template, validate, parse, render, templates) + builder at scripts/zwo_builder.py.
• Integration: Fitness agent / Tacx Flux 2; synergistic with garmin-workout (one spec, two targets).

skill-creator

Guidelines and scripts to help developers build high-quality, token-efficient Claude skills.

How to use

Add individual skill directories to your Claude context. Each skill is self-contained within its directory and driven by its SKILL.md file.

Creating New Skills

Use the templates and scripts in skills/skill-creator to bootstrap new skills:

python3 skills/skill-creator/scripts/init_skill.py <name> --path skills/