diff --git a/skills/autonomous-ai-agents/codex/SKILL.md b/skills/autonomous-ai-agents/codex/SKILL.md index b074fa66cb..aa3f358028 100644 --- a/skills/autonomous-ai-agents/codex/SKILL.md +++ b/skills/autonomous-ai-agents/codex/SKILL.md @@ -14,6 +14,15 @@ metadata: Delegate coding tasks to [Codex](https://github.com/openai/codex) via the Hermes terminal. Codex is OpenAI's autonomous coding agent CLI. +## When to use + +- Building features +- Refactoring +- PR reviews +- Batch issue fixing + +Requires the codex CLI and a git repository. + ## Prerequisites - Codex installed: `npm install -g @openai/codex` diff --git a/skills/creative/ascii-video/SKILL.md b/skills/creative/ascii-video/SKILL.md index 5180538dcb..59843c01e5 100644 --- a/skills/creative/ascii-video/SKILL.md +++ b/skills/creative/ascii-video/SKILL.md @@ -5,6 +5,14 @@ description: "ASCII video: convert video/audio to colored ASCII MP4/GIF." # ASCII Video Production Pipeline +## When to use + +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. + +## What's inside + +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. + ## Creative Standard This is visual art. ASCII characters are the medium; cinema is the standard. diff --git a/skills/creative/creative-ideation/SKILL.md b/skills/creative/creative-ideation/SKILL.md index a3849b12eb..767e867e03 100644 --- a/skills/creative/creative-ideation/SKILL.md +++ b/skills/creative/creative-ideation/SKILL.md @@ -14,6 +14,10 @@ metadata: # Creative Ideation +## When to use + +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. + Generate project ideas through creative constraints. Constraint + direction = creativity. ## How It Works diff --git a/skills/creative/excalidraw/SKILL.md b/skills/creative/excalidraw/SKILL.md index 2772ba4b8e..10a0fa38bf 100644 --- a/skills/creative/excalidraw/SKILL.md +++ b/skills/creative/excalidraw/SKILL.md @@ -16,6 +16,10 @@ metadata: Create diagrams by writing standard Excalidraw element JSON and saving as `.excalidraw` files. These files can be drag-and-dropped onto [excalidraw.com](https://excalidraw.com) for viewing and editing. No accounts, no API keys, no rendering libraries -- just JSON. +## When to use + +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. + ## Workflow 1. **Load this skill** (you already did) diff --git a/skills/creative/manim-video/SKILL.md b/skills/creative/manim-video/SKILL.md index b01ff5fee2..555f3fcd6d 100644 --- a/skills/creative/manim-video/SKILL.md +++ b/skills/creative/manim-video/SKILL.md @@ -6,6 +6,10 @@ version: 1.0.0 # Manim Video Production Pipeline +## When to use + +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. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories using Manim Community Edition. + ## Creative Standard This is educational cinema. Every frame teaches. Every animation reveals structure. diff --git a/skills/creative/p5js/SKILL.md b/skills/creative/p5js/SKILL.md index 40fd99456f..ff0a955c2a 100644 --- a/skills/creative/p5js/SKILL.md +++ b/skills/creative/p5js/SKILL.md @@ -10,6 +10,14 @@ metadata: # p5.js Production Pipeline +## When to use + +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. + +## What's inside + +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. + ## Creative Standard This is visual art rendered in the browser. The canvas is the medium; the algorithm is the brush. diff --git a/skills/media/gif-search/SKILL.md b/skills/media/gif-search/SKILL.md index 0c5a70fdec..373f31949d 100644 --- a/skills/media/gif-search/SKILL.md +++ b/skills/media/gif-search/SKILL.md @@ -16,6 +16,10 @@ metadata: Search and download GIFs directly via the Tenor API using curl. No extra tools needed. +## When to use + +Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat. + ## Setup Set your Tenor API key in your environment (add to `~/.hermes/.env`): diff --git a/skills/media/heartmula/SKILL.md b/skills/media/heartmula/SKILL.md index 3815ff9c7e..1a26cf44f6 100644 --- a/skills/media/heartmula/SKILL.md +++ b/skills/media/heartmula/SKILL.md @@ -11,7 +11,7 @@ metadata: # HeartMuLa - Open-Source Music Generation ## Overview -HeartMuLa is a family of open-source music foundation models (Apache-2.0) that generates music conditioned on lyrics and tags. Comparable to Suno for open-source. Includes: +HeartMuLa is a family of open-source music foundation models (Apache-2.0) that generates music conditioned on lyrics and tags, with multilingual support. Generates full songs from lyrics + tags. Comparable to Suno for open-source. Includes: - **HeartMuLa** - Music language model (3B/7B) for generation from lyrics + tags - **HeartCodec** - 12.5Hz music codec for high-fidelity audio reconstruction - **HeartTranscriptor** - Whisper-based lyrics transcription diff --git a/skills/media/youtube-content/SKILL.md b/skills/media/youtube-content/SKILL.md index 2d3c04a0dc..82181d704c 100644 --- a/skills/media/youtube-content/SKILL.md +++ b/skills/media/youtube-content/SKILL.md @@ -5,6 +5,10 @@ description: "YouTube transcripts to summaries, threads, blogs." # YouTube Content Tool +## When to use + +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. Transforms transcripts into structured content (chapters, summaries, threads, blog posts). + Extract transcripts from YouTube videos and convert them into useful formats. ## Setup diff --git a/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md b/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md index 1329f6f734..ab0325bd4f 100644 --- a/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md +++ b/skills/mlops/evaluation/lm-evaluation-harness/SKILL.md @@ -13,6 +13,10 @@ metadata: # lm-evaluation-harness - LLM Benchmarking +## What's inside + +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. + ## Quick start lm-evaluation-harness evaluates LLMs across 60+ academic benchmarks using standardized prompts and metrics. diff --git a/skills/mlops/inference/obliteratus/SKILL.md b/skills/mlops/inference/obliteratus/SKILL.md index d931c52a2b..14e5770a83 100644 --- a/skills/mlops/inference/obliteratus/SKILL.md +++ b/skills/mlops/inference/obliteratus/SKILL.md @@ -13,6 +13,10 @@ metadata: # OBLITERATUS Skill +## What's inside + +9 CLI methods, 28 analysis modules, 116 model presets across 5 compute tiers, tournament evaluation, and telemetry-driven recommendations. + Remove refusal behaviors (guardrails) from open-weight LLMs without retraining or fine-tuning. Uses mechanistic interpretability techniques — including diff-in-means, SVD, whitened SVD, LEACE concept erasure, SAE decomposition, Bayesian kernel projection, and more — to identify and surgically excise refusal directions from model weights while preserving reasoning capabilities. **License warning:** OBLITERATUS is AGPL-3.0. NEVER import it as a Python library. Always invoke via CLI (`obliteratus` command) or subprocess. This keeps Hermes Agent's MIT license clean. diff --git a/skills/mlops/inference/vllm/SKILL.md b/skills/mlops/inference/vllm/SKILL.md index 98df852d4d..a88dd45c19 100644 --- a/skills/mlops/inference/vllm/SKILL.md +++ b/skills/mlops/inference/vllm/SKILL.md @@ -13,6 +13,10 @@ metadata: # vLLM - High-Performance LLM Serving +## When to use + +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. + ## Quick start vLLM achieves 24x higher throughput than standard transformers through PagedAttention (block-based KV cache) and continuous batching (mixing prefill/decode requests). diff --git a/skills/mlops/training/axolotl/SKILL.md b/skills/mlops/training/axolotl/SKILL.md index 1f85ad8feb..435b642856 100644 --- a/skills/mlops/training/axolotl/SKILL.md +++ b/skills/mlops/training/axolotl/SKILL.md @@ -13,6 +13,10 @@ metadata: # Axolotl Skill +## What's inside + +Expert guidance for fine-tuning LLMs with Axolotl — YAML configs, 100+ models, LoRA/QLoRA, DPO/KTO/ORPO/GRPO, multimodal support. + Comprehensive assistance with axolotl development, generated from official documentation. ## When to Use This Skill diff --git a/skills/productivity/powerpoint/SKILL.md b/skills/productivity/powerpoint/SKILL.md index bca28b0b05..13fa0dfaf1 100644 --- a/skills/productivity/powerpoint/SKILL.md +++ b/skills/productivity/powerpoint/SKILL.md @@ -6,6 +6,10 @@ license: Proprietary. LICENSE.txt has complete terms # Powerpoint Skill +## When to use + +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. + ## Quick Reference | Task | Guide |