#!/usr/bin/env python3
"""List available Hermes skills by category."""

SKILLS = [
    ("autonomous-ai-agents", "claude-code", "Delegate coding to Claude Code CLI (features, PRs)."),
    ("autonomous-ai-agents", "codex", "Delegate coding to OpenAI Codex CLI (features, PRs)."),
    ("autonomous-ai-agents", "computer-use", "Drive the desktop background-first; escalate on signal."),
    ("autonomous-ai-agents", "hermes-agent", "Use, configure, theme, extend, and orchestrate Hermes Agent."),
    ("autonomous-ai-agents", "opencode", "Delegate coding to OpenCode CLI (features, PR review)."),
    ("creative", "architecture-diagram", "Dark-themed SVG architecture/cloud/infra diagrams as HTML."),
    ("creative", "ascii-video", "ASCII video: convert video/audio to colored ASCII MP4/GIF."),
    ("creative", "baoyu-infographic", "Infographics: 21 layouts x 21 styles."),
    ("creative", "claude-design", "Design one-off HTML artifacts (landing, deck, prototype)."),
    ("creative", "design-md", "Author/validate/export Google's DESIGN.md token spec files."),
    ("creative", "humanizer", "Humanize text: strip AI-isms and add real voice."),
    ("creative", "manim-video", "Manim CE animations: 3Blue1Brown math/algo videos."),
    ("creative", "p5js", "p5.js sketches: gen art, shaders, interactive, 3D."),
    ("creative", "popular-web-designs", "54 real design systems (Stripe, Linear, Vercel) as HTML/CSS."),
    ("creative", "songwriting-and-ai-music", "Songwriting craft and Suno AI music prompts."),
    ("devops", "sdlc-review", "Review Kanban handoffs and route verified outcomes."),
    ("email", "email-inbox-triage", "Triage an inbox: prioritize threads, draft replies safely."),
    ("email", "himalaya", "Himalaya CLI: IMAP/SMTP email from terminal."),
    ("media", "gif-search", "Search/download GIFs from Tenor via curl + jq."),
    ("media", "songsee", "Audio spectrograms/features (mel, chroma, MFCC) via CLI."),
    ("media", "youtube-content", "YouTube transcripts to summaries, threads, blogs."),
    ("note-taking", "obsidian", "Read, search, create, and edit notes in Obsidian vault."),
    ("productivity", "airtable", "Airtable REST API via curl. Records CRUD, filters, upserts."),
    ("productivity", "box", "Box manages cloud files, sharing, search, metadata."),
    ("productivity", "document-to-action-items", "Extract obligations, deadlines, tasks from documents."),
    ("productivity", "docx", "Create, read, edit, template, review Word .docx files."),
    ("productivity", "google-workspace", "Gmail, Calendar, Drive, Docs, Sheets via gws CLI."),
    ("productivity", "maps", "Geocode, POIs, routes, timezones via OpenStreetMap/OSRM."),
    ("productivity", "meeting-action-items", "Turn meeting notes into decisions, owners, tickets."),
    ("productivity", "notion", "Notion API + ntn CLI: pages, databases, markdown."),
    ("productivity", "pdf", "PDF files: create, read, merge, fill, OCR, edit text."),
    ("productivity", "powerpoint", "Create, read, edit .pptx decks with python-pptx."),
    ("productivity", "product-price-monitor", "Watch product/flight prices; alert on target."),
    ("productivity", "teams-meeting-pipeline", "Teams meetings, summaries, job replay."),
    ("productivity", "weekly-review-planning", "Weekly reset: commitments, stalled work, plan."),
    ("productivity", "xlsx", "Create, read, edit Excel .xlsx workbooks, CSVs."),
    ("research", "arxiv", "Search arXiv papers by keyword, author, category, ID."),
    ("research", "competitor-news-monitor", "Watch companies for material news; digests."),
    ("research", "grounded-citations", "Ground answers in cited, verifiable sources."),
    ("research", "llm-wiki", "Karpathy's LLM Wiki: interlinked markdown KB."),
    ("social-media", "xurl", "X/Twitter via xurl CLI: post search, posting, DM, media."),
    ("software-development", "codebase-inspection", "Inspect codebases w/ pygount: LOC, languages, ratios."),
    ("software-development", "dogfood", "Exploratory QA: find bugs, evidence, reports."),
    ("software-development", "github", "GitHub via gh CLI: PRs, issues, reviews, repos, auth."),
    ("software-development", "hermes-agent-skill-authoring", "Author SKILL.md files: frontmatter and structure."),
    ("software-development", "inspecting-hermes-desktop-dom", "Read live Hermes desktop DOM/CSS over CDP."),
    ("software-development", "node-inspect-debugger", "Debug Node.js via --inspect + Chrome DevTools."),
    ("software-development", "python-debugpy", "Debug Python: pdb REPL + debugpy remote (DAP)."),
    ("software-development", "requesting-code-review", "Pre-commit review: security scan, gates, auto-fix."),
    ("software-development", "simplify-code", "Parallel cleanup of recent code changes."),
    ("software-development", "spike", "Throwaway experiments to validate ideas before build."),
    ("software-development", "systematic-debugging", "4-phase root cause debugging."),
    ("software-development", "test-driven-development", "TDD: enforce RED-GREEN-REFACTOR."),
    ("web", "blocked-page-recovery", "Use when fetch fails: 403/429, paywall, bot wall."),
]

def main():
    from collections import defaultdict
    
    by_category = defaultdict(list)
    for cat, name, desc in SKILLS:
        by_category[cat].append((name, desc))
    
    print("Hermes Skills by Category")
    print("=" * 70)
    for cat in sorted(by_category.keys()):
        skills = by_category[cat]
        print(f"\n{cat.upper()} ({len(skills)} skills)")
        print("-" * 70)
        for name, desc in skills:
            # Format as a table
            desc_short = desc[:47] + "..." if len(desc) > 50 else desc
            print(f"  {name:<35} {desc_short}")
    
    print("\n" + "=" * 70)
    print(f"TOTAL: {len(SKILLS)} skills in {len(by_category)} categories")

if __name__ == "__main__":
    main()