From e3921e7ca4a6a98c00841eb72d9bcc9b9ac99185 Mon Sep 17 00:00:00 2001 From: Teknium Date: Sun, 26 Apr 2026 21:40:16 -0700 Subject: [PATCH] docs(skills): compress 74 built-in skill descriptions to <=60 chars Target: every skill's description fits in a one-line gateway menu and leads with trigger keywords an agent would match on. Drops filler like 'Use this skill to', 'A skill for', 'This skill provides'. Before: max description length was 791 chars (architecture-diagram), 74 of 81 built-in skills were >60 chars. After: max 60, mean 54, all 81 built-in skills <=60. Rewritten with double-quoted YAML scalars to preserve Chinese/arrow glyphs (baoyu-comic, yuanbao, youtube-content). --- skills/apple/apple-notes/SKILL.md | 2 +- skills/apple/apple-reminders/SKILL.md | 2 +- skills/apple/findmy/SKILL.md | 2 +- skills/autonomous-ai-agents/claude-code/SKILL.md | 2 +- skills/autonomous-ai-agents/codex/SKILL.md | 2 +- skills/autonomous-ai-agents/hermes-agent/SKILL.md | 2 +- skills/autonomous-ai-agents/opencode/SKILL.md | 2 +- skills/creative/architecture-diagram/SKILL.md | 2 +- skills/creative/ascii-art/SKILL.md | 2 +- skills/creative/ascii-video/SKILL.md | 2 +- skills/creative/baoyu-comic/SKILL.md | 2 +- skills/creative/baoyu-infographic/SKILL.md | 2 +- skills/creative/creative-ideation/SKILL.md | 2 +- skills/creative/excalidraw/SKILL.md | 2 +- skills/creative/manim-video/SKILL.md | 2 +- skills/creative/p5js/SKILL.md | 2 +- skills/creative/pixel-art/SKILL.md | 2 +- skills/creative/songwriting-and-ai-music/SKILL.md | 5 +---- skills/data-science/jupyter-live-kernel/SKILL.md | 7 +------ skills/devops/webhook-subscriptions/SKILL.md | 2 +- skills/dogfood/SKILL.md | 2 +- skills/email/himalaya/SKILL.md | 2 +- skills/gaming/minecraft-modpack-server/SKILL.md | 2 +- skills/gaming/pokemon-player/SKILL.md | 2 +- skills/github/codebase-inspection/SKILL.md | 2 +- skills/github/github-auth/SKILL.md | 2 +- skills/github/github-code-review/SKILL.md | 2 +- skills/github/github-issues/SKILL.md | 2 +- skills/github/github-pr-workflow/SKILL.md | 2 +- skills/github/github-repo-management/SKILL.md | 2 +- skills/mcp/native-mcp/SKILL.md | 2 +- skills/media/gif-search/SKILL.md | 2 +- skills/media/heartmula/SKILL.md | 2 +- skills/media/songsee/SKILL.md | 2 +- skills/media/spotify/SKILL.md | 2 +- skills/media/youtube-content/SKILL.md | 6 +----- skills/mlops/evaluation/lm-evaluation-harness/SKILL.md | 2 +- skills/mlops/evaluation/weights-and-biases/SKILL.md | 2 +- skills/mlops/huggingface-hub/SKILL.md | 2 +- skills/mlops/inference/obliteratus/SKILL.md | 2 +- skills/mlops/inference/outlines/SKILL.md | 2 +- skills/mlops/inference/vllm/SKILL.md | 2 +- skills/mlops/models/audiocraft/SKILL.md | 2 +- skills/mlops/models/segment-anything/SKILL.md | 2 +- skills/mlops/research/dspy/SKILL.md | 2 +- skills/mlops/training/axolotl/SKILL.md | 2 +- skills/mlops/training/trl-fine-tuning/SKILL.md | 2 +- skills/mlops/training/unsloth/SKILL.md | 2 +- skills/productivity/google-workspace/SKILL.md | 2 +- skills/productivity/linear/SKILL.md | 2 +- skills/productivity/maps/SKILL.md | 7 +------ skills/productivity/nano-pdf/SKILL.md | 2 +- skills/productivity/notion/SKILL.md | 2 +- skills/productivity/ocr-and-documents/SKILL.md | 2 +- skills/productivity/powerpoint/SKILL.md | 2 +- skills/red-teaming/godmode/SKILL.md | 2 +- skills/research/arxiv/SKILL.md | 2 +- skills/research/blogwatcher/SKILL.md | 2 +- skills/research/llm-wiki/SKILL.md | 2 +- skills/research/polymarket/SKILL.md | 2 +- skills/research/research-paper-writing/SKILL.md | 2 +- skills/smart-home/openhue/SKILL.md | 2 +- skills/social-media/xurl/SKILL.md | 2 +- .../debugging-hermes-tui-commands/SKILL.md | 2 +- .../hermes-agent-skill-authoring/SKILL.md | 2 +- skills/software-development/node-inspect-debugger/SKILL.md | 2 +- skills/software-development/plan/SKILL.md | 2 +- skills/software-development/python-debugpy/SKILL.md | 2 +- .../software-development/requesting-code-review/SKILL.md | 5 +---- .../subagent-driven-development/SKILL.md | 2 +- skills/software-development/systematic-debugging/SKILL.md | 2 +- .../software-development/test-driven-development/SKILL.md | 2 +- skills/software-development/writing-plans/SKILL.md | 2 +- skills/yuanbao/SKILL.md | 2 +- 74 files changed, 74 insertions(+), 94 deletions(-) diff --git a/skills/apple/apple-notes/SKILL.md b/skills/apple/apple-notes/SKILL.md index 33fb3ef76f..020f0d641d 100644 --- a/skills/apple/apple-notes/SKILL.md +++ b/skills/apple/apple-notes/SKILL.md @@ -1,6 +1,6 @@ --- name: apple-notes -description: Manage Apple Notes via the memo CLI on macOS (create, view, search, edit). +description: "Manage Apple Notes via memo CLI: create, search, edit." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/apple/apple-reminders/SKILL.md b/skills/apple/apple-reminders/SKILL.md index 7af3933703..37c4fa74fd 100644 --- a/skills/apple/apple-reminders/SKILL.md +++ b/skills/apple/apple-reminders/SKILL.md @@ -1,6 +1,6 @@ --- name: apple-reminders -description: Manage Apple Reminders via remindctl CLI (list, add, complete, delete). +description: "Apple Reminders via remindctl: add, list, complete." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/apple/findmy/SKILL.md b/skills/apple/findmy/SKILL.md index c009b3e398..e2bed384d1 100644 --- a/skills/apple/findmy/SKILL.md +++ b/skills/apple/findmy/SKILL.md @@ -1,6 +1,6 @@ --- name: findmy -description: Track Apple devices and AirTags via FindMy.app on macOS using AppleScript and screen capture. +description: "Track Apple devices/AirTags via FindMy.app on macOS." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/autonomous-ai-agents/claude-code/SKILL.md b/skills/autonomous-ai-agents/claude-code/SKILL.md index 0b39b5c2f4..cf7692cd57 100644 --- a/skills/autonomous-ai-agents/claude-code/SKILL.md +++ b/skills/autonomous-ai-agents/claude-code/SKILL.md @@ -1,6 +1,6 @@ --- name: claude-code -description: Delegate coding tasks to Claude Code (Anthropic's CLI agent). Use for building features, refactoring, PR reviews, and iterative coding. Requires the claude CLI installed. +description: "Delegate coding to Claude Code CLI (features, PRs)." version: 2.2.0 author: Hermes Agent + Teknium license: MIT diff --git a/skills/autonomous-ai-agents/codex/SKILL.md b/skills/autonomous-ai-agents/codex/SKILL.md index e5c77a1809..b074fa66cb 100644 --- a/skills/autonomous-ai-agents/codex/SKILL.md +++ b/skills/autonomous-ai-agents/codex/SKILL.md @@ -1,6 +1,6 @@ --- name: codex -description: Delegate coding tasks to OpenAI Codex CLI agent. Use for building features, refactoring, PR reviews, and batch issue fixing. Requires the codex CLI and a git repository. +description: "Delegate coding to OpenAI Codex CLI (features, PRs)." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/autonomous-ai-agents/hermes-agent/SKILL.md b/skills/autonomous-ai-agents/hermes-agent/SKILL.md index 9cbd5ea203..7cc6bc542a 100644 --- a/skills/autonomous-ai-agents/hermes-agent/SKILL.md +++ b/skills/autonomous-ai-agents/hermes-agent/SKILL.md @@ -1,6 +1,6 @@ --- name: hermes-agent -description: Complete guide to using and extending Hermes Agent — CLI usage, setup, configuration, spawning additional agents, gateway platforms, skills, voice, tools, profiles, and a concise contributor reference. Load this skill when helping users configure Hermes, troubleshoot issues, spawn agent instances, or make code contributions. +description: "Configure, extend, or contribute to Hermes Agent." version: 2.0.0 author: Hermes Agent + Teknium license: MIT diff --git a/skills/autonomous-ai-agents/opencode/SKILL.md b/skills/autonomous-ai-agents/opencode/SKILL.md index 37707dbced..41f921bdd6 100644 --- a/skills/autonomous-ai-agents/opencode/SKILL.md +++ b/skills/autonomous-ai-agents/opencode/SKILL.md @@ -1,6 +1,6 @@ --- name: opencode -description: Delegate coding tasks to OpenCode CLI agent for feature implementation, refactoring, PR review, and long-running autonomous sessions. Requires the opencode CLI installed and authenticated. +description: "Delegate coding to OpenCode CLI (features, PR review)." version: 1.2.0 author: Hermes Agent license: MIT diff --git a/skills/creative/architecture-diagram/SKILL.md b/skills/creative/architecture-diagram/SKILL.md index 1e1749db87..a49a42c024 100644 --- a/skills/creative/architecture-diagram/SKILL.md +++ b/skills/creative/architecture-diagram/SKILL.md @@ -1,6 +1,6 @@ --- name: architecture-diagram -description: Generate dark-themed SVG diagrams of software systems and cloud infrastructure as standalone HTML files with inline SVG graphics. Semantic component colors (cyan=frontend, emerald=backend, violet=database, amber=cloud/AWS, rose=security, orange=message bus), JetBrains Mono font, grid background. Best suited for software architecture, cloud/VPC topology, microservice maps, service-mesh diagrams, database + API layer diagrams, security groups, message buses — anything that fits a tech-infra deck with a dark aesthetic. If a more specialized diagramming skill exists for the subject (scientific, educational, hand-drawn, animated, etc.), prefer that — otherwise this skill can also serve as a general-purpose SVG diagram fallback. Based on Cocoon AI's architecture-diagram-generator (MIT). +description: "Dark-themed SVG architecture/cloud/infra diagrams as HTML." version: 1.0.0 author: Cocoon AI (hello@cocoon-ai.com), ported by Hermes Agent license: MIT diff --git a/skills/creative/ascii-art/SKILL.md b/skills/creative/ascii-art/SKILL.md index 1afe7ffcb9..fe1f6bba0a 100644 --- a/skills/creative/ascii-art/SKILL.md +++ b/skills/creative/ascii-art/SKILL.md @@ -1,6 +1,6 @@ --- name: ascii-art -description: Generate ASCII art using pyfiglet (571 fonts), cowsay, boxes, toilet, image-to-ascii, remote APIs (asciified, ascii.co.uk), and LLM fallback. No API keys required. +description: "ASCII art: pyfiglet, cowsay, boxes, image-to-ascii." version: 4.0.0 author: 0xbyt4, Hermes Agent license: MIT diff --git a/skills/creative/ascii-video/SKILL.md b/skills/creative/ascii-video/SKILL.md index 704a561167..5180538dcb 100644 --- a/skills/creative/ascii-video/SKILL.md +++ b/skills/creative/ascii-video/SKILL.md @@ -1,6 +1,6 @@ --- name: ascii-video -description: "Production pipeline for ASCII art video — any format. Converts video/audio/images/generative input into colored ASCII character video output (MP4, GIF, image sequence). Covers: video-to-ASCII conversion, audio-reactive music visualizers, generative ASCII art animations, hybrid video+audio reactive, text/lyrics overlays, real-time terminal rendering. Use when users request: ASCII video, text art video, terminal-style video, character art animation, retro text visualization, audio visualizer in ASCII, converting video to ASCII art, matrix-style effects, or any animated ASCII output." +description: "ASCII video: convert video/audio to colored ASCII MP4/GIF." --- # ASCII Video Production Pipeline diff --git a/skills/creative/baoyu-comic/SKILL.md b/skills/creative/baoyu-comic/SKILL.md index d3c89ed4c7..6b3bef6e33 100644 --- a/skills/creative/baoyu-comic/SKILL.md +++ b/skills/creative/baoyu-comic/SKILL.md @@ -1,6 +1,6 @@ --- name: baoyu-comic -description: Knowledge comic creator supporting multiple art styles and tones. Creates original educational comics with detailed panel layouts and sequential image generation. Use when user asks to create "知识漫画", "教育漫画", "biography comic", "tutorial comic", or "Logicomix-style comic". +description: "Knowledge comics (知识漫画): educational, biography, tutorial." version: 1.56.1 author: 宝玉 (JimLiu) license: MIT diff --git a/skills/creative/baoyu-infographic/SKILL.md b/skills/creative/baoyu-infographic/SKILL.md index fea3499cbf..740bd164d0 100644 --- a/skills/creative/baoyu-infographic/SKILL.md +++ b/skills/creative/baoyu-infographic/SKILL.md @@ -1,6 +1,6 @@ --- name: baoyu-infographic -description: Generate professional infographics with 21 layout types and 21 visual styles. Analyzes content, recommends layout×style combinations, and generates publication-ready infographics. Use when user asks to create "infographic", "visual summary", "信息图", "可视化", or "高密度信息大图". +description: "Infographics: 21 layouts x 21 styles (信息图, 可视化)." version: 1.56.1 author: 宝玉 (JimLiu) license: MIT diff --git a/skills/creative/creative-ideation/SKILL.md b/skills/creative/creative-ideation/SKILL.md index a5feba5c57..a3849b12eb 100644 --- a/skills/creative/creative-ideation/SKILL.md +++ b/skills/creative/creative-ideation/SKILL.md @@ -1,7 +1,7 @@ --- name: ideation title: Creative Ideation — Constraint-Driven Project Generation -description: "Generate project ideas through creative constraints. Use when the user says 'I want to build something', 'give me a project idea', 'I'm bored', 'what should I make', 'inspire me', or any variant of 'I have tools but no direction'. Works for code, art, hardware, writing, tools, and anything that can be made." +description: "Generate project ideas via creative constraints." version: 1.0.0 author: SHL0MS license: MIT diff --git a/skills/creative/excalidraw/SKILL.md b/skills/creative/excalidraw/SKILL.md index 195f80ab33..2772ba4b8e 100644 --- a/skills/creative/excalidraw/SKILL.md +++ b/skills/creative/excalidraw/SKILL.md @@ -1,6 +1,6 @@ --- name: excalidraw -description: Create hand-drawn style diagrams using Excalidraw JSON format. Generate .excalidraw files for architecture diagrams, flowcharts, sequence diagrams, concept maps, and more. Files can be opened at excalidraw.com or uploaded for shareable links. +description: "Hand-drawn Excalidraw JSON diagrams (arch, flow, seq)." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/creative/manim-video/SKILL.md b/skills/creative/manim-video/SKILL.md index 6edab8e742..b01ff5fee2 100644 --- a/skills/creative/manim-video/SKILL.md +++ b/skills/creative/manim-video/SKILL.md @@ -1,6 +1,6 @@ --- name: manim-video -description: "Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content." +description: "Manim CE animations: 3Blue1Brown math/algo videos." version: 1.0.0 --- diff --git a/skills/creative/p5js/SKILL.md b/skills/creative/p5js/SKILL.md index 1b8e618041..40fd99456f 100644 --- a/skills/creative/p5js/SKILL.md +++ b/skills/creative/p5js/SKILL.md @@ -1,6 +1,6 @@ --- name: p5js -description: "Production pipeline for interactive and generative visual art using p5.js. Creates browser-based sketches, generative art, data visualizations, interactive experiences, 3D scenes, audio-reactive visuals, and motion graphics — exported as HTML, PNG, GIF, MP4, or SVG. Covers: 2D/3D rendering, noise and particle systems, flow fields, shaders (GLSL), pixel manipulation, kinetic typography, WebGL scenes, audio analysis, mouse/keyboard interaction, and headless high-res export. Use when users request: p5.js sketches, creative coding, generative art, interactive visualizations, canvas animations, browser-based visual art, data viz, shader effects, or any p5.js project." +description: "p5.js sketches: gen art, shaders, interactive, 3D." version: 1.0.0 metadata: hermes: diff --git a/skills/creative/pixel-art/SKILL.md b/skills/creative/pixel-art/SKILL.md index e123fc6327..596712bf97 100644 --- a/skills/creative/pixel-art/SKILL.md +++ b/skills/creative/pixel-art/SKILL.md @@ -1,6 +1,6 @@ --- name: pixel-art -description: Convert images into retro pixel art with hardware-accurate palettes (NES, Game Boy, PICO-8, C64, etc.), and animate them into short videos. Presets cover arcade, SNES, and 10+ era-correct looks. Use `clarify` to let the user pick a style before generating. +description: "Pixel art w/ era palettes (NES, Game Boy, PICO-8)." version: 2.0.0 author: dodo-reach license: MIT diff --git a/skills/creative/songwriting-and-ai-music/SKILL.md b/skills/creative/songwriting-and-ai-music/SKILL.md index 2f1fc72825..84bc3bc313 100644 --- a/skills/creative/songwriting-and-ai-music/SKILL.md +++ b/skills/creative/songwriting-and-ai-music/SKILL.md @@ -1,9 +1,6 @@ --- name: songwriting-and-ai-music -description: > - Songwriting craft, AI music generation prompts (Suno focus), parody/adaptation - techniques, phonetic tricks, and lessons learned. These are tools and ideas, - not rules. Break any of them when the art calls for it. +description: "Songwriting craft and Suno AI music prompts." tags: [songwriting, music, suno, parody, lyrics, creative] triggers: - writing a song diff --git a/skills/data-science/jupyter-live-kernel/SKILL.md b/skills/data-science/jupyter-live-kernel/SKILL.md index 984cd9e8ff..bfb4cd5b86 100644 --- a/skills/data-science/jupyter-live-kernel/SKILL.md +++ b/skills/data-science/jupyter-live-kernel/SKILL.md @@ -1,11 +1,6 @@ --- name: jupyter-live-kernel -description: > - Use a live Jupyter kernel for stateful, iterative Python execution via hamelnb. - Load this skill when the task involves exploration, iteration, or inspecting - intermediate results — data science, ML experimentation, API exploration, or - building up complex code step-by-step. Uses terminal to run CLI commands against - a live Jupyter kernel. No new tools required. +description: "Iterative Python via live Jupyter kernel (hamelnb)." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/devops/webhook-subscriptions/SKILL.md b/skills/devops/webhook-subscriptions/SKILL.md index dd20a19b41..6e4e896ec3 100644 --- a/skills/devops/webhook-subscriptions/SKILL.md +++ b/skills/devops/webhook-subscriptions/SKILL.md @@ -1,6 +1,6 @@ --- name: webhook-subscriptions -description: Create and manage webhook subscriptions for event-driven agent activation, or for direct push notifications (zero LLM cost). Use when the user wants external services to trigger agent runs OR push notifications to chats. +description: "Webhook subscriptions: event-driven agent runs." version: 1.1.0 metadata: hermes: diff --git a/skills/dogfood/SKILL.md b/skills/dogfood/SKILL.md index b7ba366395..27573521b8 100644 --- a/skills/dogfood/SKILL.md +++ b/skills/dogfood/SKILL.md @@ -1,6 +1,6 @@ --- name: dogfood -description: Systematic exploratory QA testing of web applications — find bugs, capture evidence, and generate structured reports +description: "Exploratory QA of web apps: find bugs, evidence, reports." version: 1.0.0 metadata: hermes: diff --git a/skills/email/himalaya/SKILL.md b/skills/email/himalaya/SKILL.md index ddbf51aaec..b04a4270df 100644 --- a/skills/email/himalaya/SKILL.md +++ b/skills/email/himalaya/SKILL.md @@ -1,6 +1,6 @@ --- name: himalaya -description: CLI to manage emails via IMAP/SMTP. Use himalaya to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language). +description: "Himalaya CLI: IMAP/SMTP email from terminal." version: 1.0.0 author: community license: MIT diff --git a/skills/gaming/minecraft-modpack-server/SKILL.md b/skills/gaming/minecraft-modpack-server/SKILL.md index 2645256a18..e307f72f4f 100644 --- a/skills/gaming/minecraft-modpack-server/SKILL.md +++ b/skills/gaming/minecraft-modpack-server/SKILL.md @@ -1,6 +1,6 @@ --- name: minecraft-modpack-server -description: Set up a modded Minecraft server from a CurseForge/Modrinth server pack zip. Covers NeoForge/Forge install, Java version, JVM tuning, firewall, LAN config, backups, and launch scripts. +description: "Host modded Minecraft servers (CurseForge, Modrinth)." tags: [minecraft, gaming, server, neoforge, forge, modpack] --- diff --git a/skills/gaming/pokemon-player/SKILL.md b/skills/gaming/pokemon-player/SKILL.md index 4d23f137e7..2a505cca6e 100644 --- a/skills/gaming/pokemon-player/SKILL.md +++ b/skills/gaming/pokemon-player/SKILL.md @@ -1,6 +1,6 @@ --- name: pokemon-player -description: Play Pokemon games autonomously via headless emulation. Starts a game server, reads structured game state from RAM, makes strategic decisions, and sends button inputs — all from the terminal. +description: "Play Pokemon via headless emulator + RAM reads." tags: [gaming, pokemon, emulator, pyboy, gameplay, gameboy] --- # Pokemon Player diff --git a/skills/github/codebase-inspection/SKILL.md b/skills/github/codebase-inspection/SKILL.md index 6954ad841a..b52b8d1728 100644 --- a/skills/github/codebase-inspection/SKILL.md +++ b/skills/github/codebase-inspection/SKILL.md @@ -1,6 +1,6 @@ --- name: codebase-inspection -description: Inspect and analyze codebases using pygount for LOC counting, language breakdown, and code-vs-comment ratios. Use when asked to check lines of code, repo size, language composition, or codebase stats. +description: "Inspect codebases w/ pygount: LOC, languages, ratios." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/github/github-auth/SKILL.md b/skills/github/github-auth/SKILL.md index ea8f369c42..b4f0ddef65 100644 --- a/skills/github/github-auth/SKILL.md +++ b/skills/github/github-auth/SKILL.md @@ -1,6 +1,6 @@ --- name: github-auth -description: Set up GitHub authentication for the agent using git (universally available) or the gh CLI. Covers HTTPS tokens, SSH keys, credential helpers, and gh auth — with a detection flow to pick the right method automatically. +description: "GitHub auth setup: HTTPS tokens, SSH keys, gh CLI login." version: 1.1.0 author: Hermes Agent license: MIT diff --git a/skills/github/github-code-review/SKILL.md b/skills/github/github-code-review/SKILL.md index 8041fbb6e1..a2f1e546d3 100644 --- a/skills/github/github-code-review/SKILL.md +++ b/skills/github/github-code-review/SKILL.md @@ -1,6 +1,6 @@ --- name: github-code-review -description: Review code changes by analyzing git diffs, leaving inline comments on PRs, and performing thorough pre-push review. Works with gh CLI or falls back to git + GitHub REST API via curl. +description: "Review PRs: diffs, inline comments via gh or REST." version: 1.1.0 author: Hermes Agent license: MIT diff --git a/skills/github/github-issues/SKILL.md b/skills/github/github-issues/SKILL.md index a3bceb8e33..fe6e6e0c18 100644 --- a/skills/github/github-issues/SKILL.md +++ b/skills/github/github-issues/SKILL.md @@ -1,6 +1,6 @@ --- name: github-issues -description: Create, manage, triage, and close GitHub issues. Search existing issues, add labels, assign people, and link to PRs. Works with gh CLI or falls back to git + GitHub REST API via curl. +description: "Create, triage, label, assign GitHub issues via gh or REST." version: 1.1.0 author: Hermes Agent license: MIT diff --git a/skills/github/github-pr-workflow/SKILL.md b/skills/github/github-pr-workflow/SKILL.md index 48f15ed7ad..e3ca20fb34 100644 --- a/skills/github/github-pr-workflow/SKILL.md +++ b/skills/github/github-pr-workflow/SKILL.md @@ -1,6 +1,6 @@ --- name: github-pr-workflow -description: Full pull request lifecycle — create branches, commit changes, open PRs, monitor CI status, auto-fix failures, and merge. Works with gh CLI or falls back to git + GitHub REST API via curl. +description: "GitHub PR lifecycle: branch, commit, open, CI, merge." version: 1.1.0 author: Hermes Agent license: MIT diff --git a/skills/github/github-repo-management/SKILL.md b/skills/github/github-repo-management/SKILL.md index b3732f29aa..0ca8830c9c 100644 --- a/skills/github/github-repo-management/SKILL.md +++ b/skills/github/github-repo-management/SKILL.md @@ -1,6 +1,6 @@ --- name: github-repo-management -description: Clone, create, fork, configure, and manage GitHub repositories. Manage remotes, secrets, releases, and workflows. Works with gh CLI or falls back to git + GitHub REST API via curl. +description: "Clone/create/fork repos; manage remotes, releases." version: 1.1.0 author: Hermes Agent license: MIT diff --git a/skills/mcp/native-mcp/SKILL.md b/skills/mcp/native-mcp/SKILL.md index e56bf3fc15..a14aa58d15 100644 --- a/skills/mcp/native-mcp/SKILL.md +++ b/skills/mcp/native-mcp/SKILL.md @@ -1,6 +1,6 @@ --- name: native-mcp -description: Built-in MCP (Model Context Protocol) client that connects to external MCP servers, discovers their tools, and registers them as native Hermes Agent tools. Supports stdio and HTTP transports with automatic reconnection, security filtering, and zero-config tool injection. +description: "MCP client: connect servers, register tools (stdio/HTTP)." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/media/gif-search/SKILL.md b/skills/media/gif-search/SKILL.md index ee55cac886..0c5a70fdec 100644 --- a/skills/media/gif-search/SKILL.md +++ b/skills/media/gif-search/SKILL.md @@ -1,6 +1,6 @@ --- name: gif-search -description: Search and download GIFs from Tenor using curl. No dependencies beyond curl and jq. Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat. +description: "Search/download GIFs from Tenor via curl + jq." version: 1.1.0 author: Hermes Agent license: MIT diff --git a/skills/media/heartmula/SKILL.md b/skills/media/heartmula/SKILL.md index d8905dd5d5..3815ff9c7e 100644 --- a/skills/media/heartmula/SKILL.md +++ b/skills/media/heartmula/SKILL.md @@ -1,6 +1,6 @@ --- name: heartmula -description: Set up and run HeartMuLa, the open-source music generation model family (Suno-like). Generates full songs from lyrics + tags with multilingual support. +description: "HeartMuLa: Suno-like song generation from lyrics + tags." version: 1.0.0 metadata: hermes: diff --git a/skills/media/songsee/SKILL.md b/skills/media/songsee/SKILL.md index 11bcca0c7d..5904e41f3f 100644 --- a/skills/media/songsee/SKILL.md +++ b/skills/media/songsee/SKILL.md @@ -1,6 +1,6 @@ --- name: songsee -description: Generate spectrograms and audio feature visualizations (mel, chroma, MFCC, tempogram, etc.) from audio files via CLI. Useful for audio analysis, music production debugging, and visual documentation. +description: "Audio spectrograms/features (mel, chroma, MFCC) via CLI." version: 1.0.0 author: community license: MIT diff --git a/skills/media/spotify/SKILL.md b/skills/media/spotify/SKILL.md index 612eec16fa..c0a15d6dc5 100644 --- a/skills/media/spotify/SKILL.md +++ b/skills/media/spotify/SKILL.md @@ -1,6 +1,6 @@ --- name: spotify -description: Control Spotify — play music, search the catalog, manage playlists and library, inspect devices and playback state. Loads when the user asks to play/pause/queue music, search tracks/albums/artists, manage playlists, or check what's playing. Assumes the Hermes Spotify toolset is enabled and `hermes auth spotify` has been run. +description: "Spotify: play, search, queue, manage playlists and devices." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/media/youtube-content/SKILL.md b/skills/media/youtube-content/SKILL.md index 8fb1b4447c..2d3c04a0dc 100644 --- a/skills/media/youtube-content/SKILL.md +++ b/skills/media/youtube-content/SKILL.md @@ -1,10 +1,6 @@ --- name: youtube-content -description: > - Fetch YouTube video transcripts and transform them into structured content - (chapters, summaries, threads, blog posts). Use when the user shares a YouTube - URL or video link, asks to summarize a video, requests a transcript, or wants - to extract and reformat content from any YouTube video. +description: "YouTube transcripts to summaries, threads, blogs." --- # YouTube Content Tool diff --git a/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md b/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md index 7b820424fb..1329f6f734 100644 --- a/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md +++ b/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md @@ -1,6 +1,6 @@ --- name: evaluating-llms-harness -description: Evaluates LLMs across 60+ academic benchmarks (MMLU, HumanEval, GSM8K, TruthfulQA, HellaSwag). Use when benchmarking model quality, comparing models, reporting academic results, or tracking training progress. Industry standard used by EleutherAI, HuggingFace, and major labs. Supports HuggingFace, vLLM, APIs. +description: "lm-eval-harness: benchmark LLMs (MMLU, GSM8K, etc.)." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/evaluation/weights-and-biases/SKILL.md b/skills/mlops/evaluation/weights-and-biases/SKILL.md index be02cb04c5..bb026f4e91 100644 --- a/skills/mlops/evaluation/weights-and-biases/SKILL.md +++ b/skills/mlops/evaluation/weights-and-biases/SKILL.md @@ -1,6 +1,6 @@ --- name: weights-and-biases -description: Track ML experiments with automatic logging, visualize training in real-time, optimize hyperparameters with sweeps, and manage model registry with W&B - collaborative MLOps platform +description: "W&B: log ML experiments, sweeps, model registry, dashboards." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/huggingface-hub/SKILL.md b/skills/mlops/huggingface-hub/SKILL.md index 91777542a7..218a1ee16a 100644 --- a/skills/mlops/huggingface-hub/SKILL.md +++ b/skills/mlops/huggingface-hub/SKILL.md @@ -1,6 +1,6 @@ --- name: huggingface-hub -description: Hugging Face Hub CLI (hf) — search, download, and upload models and datasets, manage repos, query datasets with SQL, deploy inference endpoints, manage Spaces and buckets. +description: "HuggingFace hf CLI: search/download/upload models, datasets." version: 1.0.0 author: Hugging Face license: MIT diff --git a/skills/mlops/inference/obliteratus/SKILL.md b/skills/mlops/inference/obliteratus/SKILL.md index 2dc2f943b1..d931c52a2b 100644 --- a/skills/mlops/inference/obliteratus/SKILL.md +++ b/skills/mlops/inference/obliteratus/SKILL.md @@ -1,6 +1,6 @@ --- name: obliteratus -description: Remove refusal behaviors from open-weight LLMs using OBLITERATUS — mechanistic interpretability techniques (diff-in-means, SVD, whitened SVD, LEACE, SAE decomposition, etc.) to excise guardrails while preserving reasoning. 9 CLI methods, 28 analysis modules, 116 model presets across 5 compute tiers, tournament evaluation, and telemetry-driven recommendations. Use when a user wants to uncensor, abliterate, or remove refusal from an LLM. +description: "OBLITERATUS: abliterate LLM refusals (diff-in-means)." version: 2.0.0 author: Hermes Agent license: MIT diff --git a/skills/mlops/inference/outlines/SKILL.md b/skills/mlops/inference/outlines/SKILL.md index d7a33247f5..8415a9a65c 100644 --- a/skills/mlops/inference/outlines/SKILL.md +++ b/skills/mlops/inference/outlines/SKILL.md @@ -1,6 +1,6 @@ --- name: outlines -description: Guarantee valid JSON/XML/code structure during generation, use Pydantic models for type-safe outputs, support local models (Transformers, vLLM), and maximize inference speed with Outlines - dottxt.ai's structured generation library +description: "Outlines: structured JSON/regex/Pydantic LLM generation." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/inference/vllm/SKILL.md b/skills/mlops/inference/vllm/SKILL.md index a197e20b6b..98df852d4d 100644 --- a/skills/mlops/inference/vllm/SKILL.md +++ b/skills/mlops/inference/vllm/SKILL.md @@ -1,6 +1,6 @@ --- name: serving-llms-vllm -description: Serves LLMs with high throughput using vLLM's PagedAttention and continuous batching. Use when deploying production LLM APIs, optimizing inference latency/throughput, or serving models with limited GPU memory. Supports OpenAI-compatible endpoints, quantization (GPTQ/AWQ/FP8), and tensor parallelism. +description: "vLLM: high-throughput LLM serving, OpenAI API, quantization." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/models/audiocraft/SKILL.md b/skills/mlops/models/audiocraft/SKILL.md index 3d3bf71585..b00bce4390 100644 --- a/skills/mlops/models/audiocraft/SKILL.md +++ b/skills/mlops/models/audiocraft/SKILL.md @@ -1,6 +1,6 @@ --- name: audiocraft-audio-generation -description: PyTorch library for audio generation including text-to-music (MusicGen) and text-to-sound (AudioGen). Use when you need to generate music from text descriptions, create sound effects, or perform melody-conditioned music generation. +description: "AudioCraft: MusicGen text-to-music, AudioGen text-to-sound." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/models/segment-anything/SKILL.md b/skills/mlops/models/segment-anything/SKILL.md index 2fea761411..a21e05ee4c 100644 --- a/skills/mlops/models/segment-anything/SKILL.md +++ b/skills/mlops/models/segment-anything/SKILL.md @@ -1,6 +1,6 @@ --- name: segment-anything-model -description: Foundation model for image segmentation with zero-shot transfer. Use when you need to segment any object in images using points, boxes, or masks as prompts, or automatically generate all object masks in an image. +description: "SAM: zero-shot image segmentation via points, boxes, masks." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/research/dspy/SKILL.md b/skills/mlops/research/dspy/SKILL.md index 2084019959..2cb1ddc84b 100644 --- a/skills/mlops/research/dspy/SKILL.md +++ b/skills/mlops/research/dspy/SKILL.md @@ -1,6 +1,6 @@ --- name: dspy -description: Build complex AI systems with declarative programming, optimize prompts automatically, create modular RAG systems and agents with DSPy - Stanford NLP's framework for systematic LM programming +description: "DSPy: declarative LM programs, auto-optimize prompts, RAG." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/training/axolotl/SKILL.md b/skills/mlops/training/axolotl/SKILL.md index 3c355f1bd5..1f85ad8feb 100644 --- a/skills/mlops/training/axolotl/SKILL.md +++ b/skills/mlops/training/axolotl/SKILL.md @@ -1,6 +1,6 @@ --- name: axolotl -description: Expert guidance for fine-tuning LLMs with Axolotl - YAML configs, 100+ models, LoRA/QLoRA, DPO/KTO/ORPO/GRPO, multimodal support +description: "Axolotl: YAML LLM fine-tuning (LoRA, DPO, GRPO)." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/training/trl-fine-tuning/SKILL.md b/skills/mlops/training/trl-fine-tuning/SKILL.md index 70023fc707..c730759bd6 100644 --- a/skills/mlops/training/trl-fine-tuning/SKILL.md +++ b/skills/mlops/training/trl-fine-tuning/SKILL.md @@ -1,6 +1,6 @@ --- name: fine-tuning-with-trl -description: Fine-tune LLMs using reinforcement learning with TRL - SFT for instruction tuning, DPO for preference alignment, PPO/GRPO for reward optimization, and reward model training. Use when need RLHF, align model with preferences, or train from human feedback. Works with HuggingFace Transformers. +description: "TRL: SFT, DPO, PPO, GRPO, reward modeling for LLM RLHF." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/mlops/training/unsloth/SKILL.md b/skills/mlops/training/unsloth/SKILL.md index a3ecd12da8..90254747c5 100644 --- a/skills/mlops/training/unsloth/SKILL.md +++ b/skills/mlops/training/unsloth/SKILL.md @@ -1,6 +1,6 @@ --- name: unsloth -description: Expert guidance for fast fine-tuning with Unsloth - 2-5x faster training, 50-80% less memory, LoRA/QLoRA optimization +description: "Unsloth: 2-5x faster LoRA/QLoRA fine-tuning, less VRAM." version: 1.0.0 author: Orchestra Research license: MIT diff --git a/skills/productivity/google-workspace/SKILL.md b/skills/productivity/google-workspace/SKILL.md index ebde7d0e81..be5c824d67 100644 --- a/skills/productivity/google-workspace/SKILL.md +++ b/skills/productivity/google-workspace/SKILL.md @@ -1,6 +1,6 @@ --- name: google-workspace -description: Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for Hermes. Uses Hermes-managed OAuth2 setup, prefers the Google Workspace CLI (`gws`) when available for broader API coverage, and falls back to the Python client libraries otherwise. +description: "Gmail, Calendar, Drive, Docs, Sheets via gws CLI or Python." version: 1.0.0 author: Nous Research license: MIT diff --git a/skills/productivity/linear/SKILL.md b/skills/productivity/linear/SKILL.md index 6c2bf56d84..b7c23ca641 100644 --- a/skills/productivity/linear/SKILL.md +++ b/skills/productivity/linear/SKILL.md @@ -1,6 +1,6 @@ --- name: linear -description: Manage Linear issues, projects, and teams via the GraphQL API. Create, update, search, and organize issues. Uses API key auth (no OAuth needed). All operations via curl — no dependencies. +description: "Linear: manage issues, projects, teams via GraphQL + curl." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/productivity/maps/SKILL.md b/skills/productivity/maps/SKILL.md index d93692a4a6..73715a8dd5 100644 --- a/skills/productivity/maps/SKILL.md +++ b/skills/productivity/maps/SKILL.md @@ -1,11 +1,6 @@ --- name: maps -description: > - Location intelligence — geocode a place, reverse-geocode coordinates, - find nearby places (46 POI categories), driving/walking/cycling - distance + time, turn-by-turn directions, timezone lookup, bounding - box + area for a named place, and POI search within a rectangle. - Uses OpenStreetMap + Overpass + OSRM. Free, no API key. +description: "Geocode, POIs, routes, timezones via OpenStreetMap/OSRM." version: 1.2.0 author: Mibayy license: MIT diff --git a/skills/productivity/nano-pdf/SKILL.md b/skills/productivity/nano-pdf/SKILL.md index 059cb598a9..ffb3f75a2b 100644 --- a/skills/productivity/nano-pdf/SKILL.md +++ b/skills/productivity/nano-pdf/SKILL.md @@ -1,6 +1,6 @@ --- name: nano-pdf -description: Edit PDFs with natural-language instructions using the nano-pdf CLI. Modify text, fix typos, update titles, and make content changes to specific pages without manual editing. +description: "Edit PDF text/typos/titles via nano-pdf CLI (NL prompts)." version: 1.0.0 author: community license: MIT diff --git a/skills/productivity/notion/SKILL.md b/skills/productivity/notion/SKILL.md index c74d0df619..0664bd8edb 100644 --- a/skills/productivity/notion/SKILL.md +++ b/skills/productivity/notion/SKILL.md @@ -1,6 +1,6 @@ --- name: notion -description: Notion API for creating and managing pages, databases, and blocks via curl. Search, create, update, and query Notion workspaces directly from the terminal. +description: "Notion API via curl: pages, databases, blocks, search." version: 1.0.0 author: community license: MIT diff --git a/skills/productivity/ocr-and-documents/SKILL.md b/skills/productivity/ocr-and-documents/SKILL.md index 2fdf4ea413..e47e5a015e 100644 --- a/skills/productivity/ocr-and-documents/SKILL.md +++ b/skills/productivity/ocr-and-documents/SKILL.md @@ -1,6 +1,6 @@ --- name: ocr-and-documents -description: Extract text from PDFs and scanned documents. Use web_extract for remote URLs, pymupdf for local text-based PDFs, marker-pdf for OCR/scanned docs. For DOCX use python-docx, for PPTX see the powerpoint skill. +description: "Extract text from PDFs/scans (pymupdf, marker-pdf)." version: 2.3.0 author: Hermes Agent license: MIT diff --git a/skills/productivity/powerpoint/SKILL.md b/skills/productivity/powerpoint/SKILL.md index 24432093ac..bca28b0b05 100644 --- a/skills/productivity/powerpoint/SKILL.md +++ b/skills/productivity/powerpoint/SKILL.md @@ -1,6 +1,6 @@ --- name: powerpoint -description: "Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill." +description: "Create, read, edit .pptx decks, slides, notes, templates." license: Proprietary. LICENSE.txt has complete terms --- diff --git a/skills/red-teaming/godmode/SKILL.md b/skills/red-teaming/godmode/SKILL.md index fa248c0216..6cb12f86e5 100644 --- a/skills/red-teaming/godmode/SKILL.md +++ b/skills/red-teaming/godmode/SKILL.md @@ -1,6 +1,6 @@ --- name: godmode -description: "Jailbreak API-served LLMs using G0DM0D3 techniques — Parseltongue input obfuscation (33 techniques), GODMODE CLASSIC system prompt templates, ULTRAPLINIAN multi-model racing, encoding escalation, and Hermes-native prefill/system prompt integration. Use when a user wants to bypass safety filters, jailbreak a model, or red-team model robustness." +description: "Jailbreak LLMs: Parseltongue, GODMODE, ULTRAPLINIAN." version: 1.0.0 author: Hermes Agent + Teknium license: MIT diff --git a/skills/research/arxiv/SKILL.md b/skills/research/arxiv/SKILL.md index eb1ecb3c0e..5976a69b25 100644 --- a/skills/research/arxiv/SKILL.md +++ b/skills/research/arxiv/SKILL.md @@ -1,6 +1,6 @@ --- name: arxiv -description: Search and retrieve academic papers from arXiv using their free REST API. No API key needed. Search by keyword, author, category, or ID. Combine with web_extract or the ocr-and-documents skill to read full paper content. +description: "Search arXiv papers by keyword, author, category, or ID." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/research/blogwatcher/SKILL.md b/skills/research/blogwatcher/SKILL.md index bfcc4f1d4d..6d3b772209 100644 --- a/skills/research/blogwatcher/SKILL.md +++ b/skills/research/blogwatcher/SKILL.md @@ -1,6 +1,6 @@ --- name: blogwatcher -description: Monitor blogs and RSS/Atom feeds for updates using the blogwatcher-cli tool. Add blogs, scan for new articles, track read status, and filter by category. +description: "Monitor blogs and RSS/Atom feeds via blogwatcher-cli tool." version: 2.0.0 author: JulienTant (fork of Hyaxia/blogwatcher) license: MIT diff --git a/skills/research/llm-wiki/SKILL.md b/skills/research/llm-wiki/SKILL.md index 8863576acc..3a37f9595a 100644 --- a/skills/research/llm-wiki/SKILL.md +++ b/skills/research/llm-wiki/SKILL.md @@ -1,6 +1,6 @@ --- name: llm-wiki -description: "Karpathy's LLM Wiki — build and maintain a persistent, interlinked markdown knowledge base. Ingest sources, query compiled knowledge, and lint for consistency." +description: "Karpathy's LLM Wiki: build/query interlinked markdown KB." version: 2.1.0 author: Hermes Agent license: MIT diff --git a/skills/research/polymarket/SKILL.md b/skills/research/polymarket/SKILL.md index d8b0ae7ce4..da3fef658d 100644 --- a/skills/research/polymarket/SKILL.md +++ b/skills/research/polymarket/SKILL.md @@ -1,6 +1,6 @@ --- name: polymarket -description: Query Polymarket prediction market data — search markets, get prices, orderbooks, and price history. Read-only via public REST APIs, no API key needed. +description: "Query Polymarket: markets, prices, orderbooks, history." version: 1.0.0 author: Hermes Agent + Teknium tags: [polymarket, prediction-markets, market-data, trading] diff --git a/skills/research/research-paper-writing/SKILL.md b/skills/research/research-paper-writing/SKILL.md index a6f3438251..4175b93a73 100644 --- a/skills/research/research-paper-writing/SKILL.md +++ b/skills/research/research-paper-writing/SKILL.md @@ -1,7 +1,7 @@ --- name: research-paper-writing title: Research Paper Writing Pipeline -description: End-to-end pipeline for writing ML/AI research papers — from experiment design through analysis, drafting, revision, and submission. Covers NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Integrates automated experiment monitoring, statistical analysis, iterative writing, and citation verification. +description: "Write ML papers for NeurIPS/ICML/ICLR: design→submit." version: 1.1.0 author: Orchestra Research license: MIT diff --git a/skills/smart-home/openhue/SKILL.md b/skills/smart-home/openhue/SKILL.md index b3efd1700b..ac83021429 100644 --- a/skills/smart-home/openhue/SKILL.md +++ b/skills/smart-home/openhue/SKILL.md @@ -1,6 +1,6 @@ --- name: openhue -description: Control Philips Hue lights, rooms, and scenes via the OpenHue CLI. Turn lights on/off, adjust brightness, color, color temperature, and activate scenes. +description: "Control Philips Hue lights, scenes, rooms via OpenHue CLI." version: 1.0.0 author: community license: MIT diff --git a/skills/social-media/xurl/SKILL.md b/skills/social-media/xurl/SKILL.md index 1f47b2e6a0..2fe23ef857 100644 --- a/skills/social-media/xurl/SKILL.md +++ b/skills/social-media/xurl/SKILL.md @@ -1,6 +1,6 @@ --- name: xurl -description: Interact with X/Twitter via xurl, the official X API CLI. Use for posting, replying, quoting, searching, timelines, mentions, likes, reposts, bookmarks, follows, DMs, media upload, and raw v2 endpoint access. +description: "X/Twitter via xurl CLI: post, search, DM, media, v2 API." version: 1.1.1 author: xdevplatform + openclaw + Hermes Agent license: MIT diff --git a/skills/software-development/debugging-hermes-tui-commands/SKILL.md b/skills/software-development/debugging-hermes-tui-commands/SKILL.md index b09c5ecb52..31649bbc40 100644 --- a/skills/software-development/debugging-hermes-tui-commands/SKILL.md +++ b/skills/software-development/debugging-hermes-tui-commands/SKILL.md @@ -1,6 +1,6 @@ --- name: debugging-hermes-tui-commands -description: Use when debugging or adding Hermes TUI slash commands across the Python backend (hermes_cli/commands.py), the tui_gateway bridge, and the TypeScript/Ink frontend. Covers autocomplete gaps, gateway dispatch issues, and live UI-state wiring. +description: "Debug Hermes TUI slash commands: Python, gateway, Ink UI." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/software-development/hermes-agent-skill-authoring/SKILL.md b/skills/software-development/hermes-agent-skill-authoring/SKILL.md index edc5c25bef..7683ee3350 100644 --- a/skills/software-development/hermes-agent-skill-authoring/SKILL.md +++ b/skills/software-development/hermes-agent-skill-authoring/SKILL.md @@ -1,6 +1,6 @@ --- name: hermes-agent-skill-authoring -description: Use when authoring or updating a SKILL.md inside the hermes-agent repo itself (skills/ tree, committed to a branch). Covers required frontmatter, validator limits, peer-matching structure, and the write_file-vs-skill_manage distinction for in-repo skills. +description: "Author in-repo SKILL.md: frontmatter, validator, structure." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/software-development/node-inspect-debugger/SKILL.md b/skills/software-development/node-inspect-debugger/SKILL.md index 2d28955b62..e28eb60ee4 100644 --- a/skills/software-development/node-inspect-debugger/SKILL.md +++ b/skills/software-development/node-inspect-debugger/SKILL.md @@ -1,6 +1,6 @@ --- name: node-inspect-debugger -description: Use when debugging Node.js code (ui-tui, tui_gateway child processes, any Node script/test) with real breakpoints, stepping, scope inspection, and expression evaluation. Drives `node --inspect` via the Chrome DevTools Protocol from the terminal — no browser required. +description: "Debug Node.js via --inspect + Chrome DevTools Protocol CLI." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/software-development/plan/SKILL.md b/skills/software-development/plan/SKILL.md index daf6bf7928..382dd2d1fd 100644 --- a/skills/software-development/plan/SKILL.md +++ b/skills/software-development/plan/SKILL.md @@ -1,6 +1,6 @@ --- name: plan -description: Plan mode for Hermes — inspect context, write a markdown plan into the active workspace's `.hermes/plans/` directory, and do not execute the work. +description: "Plan mode: write markdown plan to .hermes/plans/, no exec." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/software-development/python-debugpy/SKILL.md b/skills/software-development/python-debugpy/SKILL.md index 1e97d40a5d..b70fdda4b1 100644 --- a/skills/software-development/python-debugpy/SKILL.md +++ b/skills/software-development/python-debugpy/SKILL.md @@ -1,6 +1,6 @@ --- name: python-debugpy -description: Use when debugging Python code (run_agent.py, cli.py, tui_gateway, tests, scripts) with real breakpoints, stepping, scope inspection, and post-mortem analysis. Covers `pdb` for interactive REPL debugging and `debugpy` for remote/headless DAP-driven sessions. +description: "Debug Python: pdb REPL + debugpy remote (DAP)." version: 1.0.0 author: Hermes Agent license: MIT diff --git a/skills/software-development/requesting-code-review/SKILL.md b/skills/software-development/requesting-code-review/SKILL.md index a5ae66e501..cbeaa237d6 100644 --- a/skills/software-development/requesting-code-review/SKILL.md +++ b/skills/software-development/requesting-code-review/SKILL.md @@ -1,9 +1,6 @@ --- name: requesting-code-review -description: > - Pre-commit verification pipeline — static security scan, baseline-aware - quality gates, independent reviewer subagent, and auto-fix loop. Use after - code changes and before committing, pushing, or opening a PR. +description: "Pre-commit review: security scan, quality gates, auto-fix." version: 2.0.0 author: Hermes Agent (adapted from obra/superpowers + MorAlekss) license: MIT diff --git a/skills/software-development/subagent-driven-development/SKILL.md b/skills/software-development/subagent-driven-development/SKILL.md index a47e4415a4..5d349c9720 100644 --- a/skills/software-development/subagent-driven-development/SKILL.md +++ b/skills/software-development/subagent-driven-development/SKILL.md @@ -1,6 +1,6 @@ --- name: subagent-driven-development -description: Use when executing implementation plans with independent tasks. Dispatches fresh delegate_task per task with two-stage review (spec compliance then code quality). +description: "Execute plans via delegate_task subagents (2-stage review)." version: 1.1.0 author: Hermes Agent (adapted from obra/superpowers) license: MIT diff --git a/skills/software-development/systematic-debugging/SKILL.md b/skills/software-development/systematic-debugging/SKILL.md index 70a68d583b..3c37c169b1 100644 --- a/skills/software-development/systematic-debugging/SKILL.md +++ b/skills/software-development/systematic-debugging/SKILL.md @@ -1,6 +1,6 @@ --- name: systematic-debugging -description: Use when encountering any bug, test failure, or unexpected behavior. 4-phase root cause investigation — NO fixes without understanding the problem first. +description: "4-phase root cause debugging: understand bugs before fixing." version: 1.1.0 author: Hermes Agent (adapted from obra/superpowers) license: MIT diff --git a/skills/software-development/test-driven-development/SKILL.md b/skills/software-development/test-driven-development/SKILL.md index 4be2d532aa..5cc6c32393 100644 --- a/skills/software-development/test-driven-development/SKILL.md +++ b/skills/software-development/test-driven-development/SKILL.md @@ -1,6 +1,6 @@ --- name: test-driven-development -description: Use when implementing any feature or bugfix, before writing implementation code. Enforces RED-GREEN-REFACTOR cycle with test-first approach. +description: "TDD: enforce RED-GREEN-REFACTOR, tests before code." version: 1.1.0 author: Hermes Agent (adapted from obra/superpowers) license: MIT diff --git a/skills/software-development/writing-plans/SKILL.md b/skills/software-development/writing-plans/SKILL.md index 92a8d0172a..728714f287 100644 --- a/skills/software-development/writing-plans/SKILL.md +++ b/skills/software-development/writing-plans/SKILL.md @@ -1,6 +1,6 @@ --- name: writing-plans -description: Use when you have a spec or requirements for a multi-step task. Creates comprehensive implementation plans with bite-sized tasks, exact file paths, and complete code examples. +description: "Write implementation plans: bite-sized tasks, paths, code." version: 1.1.0 author: Hermes Agent (adapted from obra/superpowers) license: MIT diff --git a/skills/yuanbao/SKILL.md b/skills/yuanbao/SKILL.md index 3b0fd25570..b2f79aecb6 100644 --- a/skills/yuanbao/SKILL.md +++ b/skills/yuanbao/SKILL.md @@ -1,6 +1,6 @@ --- name: yuanbao -description: Yuanbao (元宝) group interaction — @mention users, query group info and members +description: "Yuanbao (元宝) groups: @mention users, query info/members." version: 1.0.0 metadata: hermes: