Browse, search, and load reusable skills for Hermes Agent. 17 top-rated ★5 skills across 19 categories. Each skill includes a guide, how-to, and pitfalls.
Delegate complex coding tasks — features, PRs, and refactors — to Claude Code CLI. Spawns an autonomous subagent with full terminal and file access in an isolated workspace.
★ Featuredv2.0.0🔧 claude, node, git
skill_view("claude-code")
📖 Guide
Load the skill with skill_view("claude-code"). The skill handles installation verification, project context injection, and workspace isolation. Claude Code runs via PTY terminal with its own working directory.
🔧 How To
Delegate a PR: load claude-code skill → provide branch name and task description → skill auto-creates branch, implements changes, and opens PR. For features: describe requirements clearly — the subagent handles implementation, testing, and commits.
⚠️ Pitfalls
Claude Code can make destructive file changes — always review the diff before merging. PTY terminal mode has \r vs \n quirks; the skill handles terminal negotiation.
Delegate coding tasks to OpenAI's Codex CLI. Spawns an autonomous coding agent for feature implementation, bug fixes, and PRs using GPT/Codex models.
★ Featuredv1.1.0🔧 codex, node
skill_view("codex")
📖 Guide
Load skill with skill_view("codex"). The skill wraps OpenAI Codex CLI with the same delegation pattern as Claude Code — isolated workspace, project context, and PR workflow.
🔧 How To
For specific implementation tasks: load codex → describe the desired change → the agent creates a branch, writes code, tests, and opens a PR. Best for well-scoped tasks with clear acceptance criteria.
⚠️ Pitfalls
Codex CLI requires the codex binary and OAuth setup. Token usage costs apply via OpenAI billing. Not as battle-tested as Claude Code for large refactors.
Configure, extend, or contribute to Hermes Agent itself. Covers CLI setup, config management, model/provider configuration, tool enable/disable, skills, voice, gateway, and plugins.
★ Featuredv1.5.0🔧 hermes, git
skill_view("hermes-agent")
📖 Guide
Load this skill before any hermes config/setup task. It knows the actual CLI commands: hermes config set, hermes tools, hermes plugins enable, hermes setup. Never guess or invent workarounds.
🔧 How To
To change model: hermes config set model "provider/model-name". To enable a tool: hermes config set tools.enabled true. To list plugins: hermes plugins list. To set a config value: hermes config set key value.
⚠️ Pitfalls
Config syntax is YAML-based — indentation matters. Use hermes config set rather than editing config.yaml directly to avoid syntax errors. Some config changes require a restart to take effect.
Delegate coding tasks to OpenCode CLI. Supports feature implementation, code review, and PR workflows with an open-source coding agent.
v0.8.0🔧 opencode, node
skill_view("opencode")
📖 Guide
Load skill with skill_view("opencode"). Similar delegation pattern to Claude Code and Codex. OpenCode is open-source and community-driven.
🔧 How To
Best for PR review and small to medium feature work. Describe the task scope clearly and let the subagent handle implementation in an isolated workspace.
⚠️ Pitfalls
OpenCode is newer and less battle-tested than Claude Code. Community-supported — fewer guarantees on edge case handling.
Create dark-themed SVG architecture, cloud, and infrastructure diagrams rendered as interactive HTML. Supports system context, container, and deployment diagrams.
★ Featuredv1.2.0🔧 python3
skill_view("architecture-diagram")
📖 Guide
Load with skill_view("architecture-diagram"). Describe the system components and their relationships. The skill generates an HTML file with embedded SVG — open in browser to view.
🔧 How To
For a cloud architecture: describe services (load balancer → API → DB → cache) and their connections. The skill handles styling, layout, and dark theme automatically. Output is a standalone HTML file.
⚠️ Pitfalls
Not a replacement for formal diagramming tools (Draw.io, LucidChart). Best for quick visual docs. Large systems may need multiple diagrams.
Generate ASCII art using pyfiglet, cowsay, boxes, and image-to-ASCII conversion. Text banners, code art, and terminal decorations.
v1.0.0🔧 pyfiglet, cowsay, jp2a
skill_view("ascii-art")
📖 Guide
Load with skill_view("ascii-art"). Uses local tools: pyfiglet for fonts, cowsay for speech bubbles, jp2a for image conversion. All tools should be installed via pip.
🔧 How To
For a banner: "pyfiglet -f slant \"Hello World\"". For cowsay: "cowsay \"message\"". For boxes: pipe output through boxes command. For images: "jp2a image.jpg".
⚠️ Pitfalls
Requires pyfiglet, cowsay, boxes, and jp2a to be installed. Wide characters (CJK) may not render correctly in all fonts.
Convert video and audio to colored ASCII MP4 or GIF. Renders frames as ANSI-colored ASCII art for terminal-friendly video playback.
skill_view("ascii-video")
📖 Guide
Load with skill_view("ascii-video"). Uses ffmpeg for frame extraction and custom processing pipeline. Output is a standard MP4 or GIF file.
🔧 How To
Provide a video file path. The skill extracts frames, converts each to colored ASCII, and stitches them back into a video. Final output is both visually interesting and terminal-friendly.
⚠️ Pitfalls
Processing is CPU-intensive for long videos. Keep clips under 30 seconds. Resolution-dependent — lower source resolution gives better ASCII results.
Create knowledge comics (知识漫画) — educational, biographical, and tutorial comics with panel layouts and illustrated storytelling. Chinese and English supported.
skill_view("baoyu-comic")
📖 Guide
Load with skill_view("baoyu-comic"). Describe the educational topic and target audience. The skill generates panel-by-panel comic layouts with character illustrations and speech bubbles.
🔧 How To
For a tutorial comic: define the learning objective → outline 4-8 panels → describe each panel's visual and text. The skill handles layout, character consistency, and text placement.
⚠️ Pitfalls
Best for educational content. Complex technical explanations may need more panels. Character consistency across panels depends on prompt specificity.
Create infographics with 21 layouts × 21 style combinations. Supports information visualization, data storytelling, and educational graphics.
skill_view("baoyu-infographic")
📖 Guide
Load with skill_view("baoyu-infographic"). Choose from 21 layout templates and 21 visual styles. Provide the data and narrative arc.
🔧 How To
Describe your data and the story you want to tell. The skill picks the optimal layout and style. Great for blog headers, social media graphics, and presentation visuals.
⚠️ Pitfalls
Output quality depends on prompt detail. Complex datasets may need custom layouts beyond the 21 template options.
Design one-off HTML artifacts — landing pages, slide decks, interactive prototypes. Full control over layout, animations, and interactivity via raw HTML/CSS/JS.
★ Featuredv1.4.0
skill_view("claude-design")
📖 Guide
Load with skill_view("claude-design"). Describe the desired design — inspiration, layout, color scheme. The skill generates a complete, self-contained HTML file.
🔧 How To
For a landing page: describe the brand, sections needed (hero, features, CTA), and desired aesthetic. The skill produces production-ready HTML with responsive design, animations, and dark/light mode support.
⚠️ Pitfalls
Not for multi-page sites — single HTML artifacts only. Complex interactivity may need framework-level tooling. CSS-only animations preferred for compatibility.
Generate images, video, and audio using ComfyUI. Install workflows, run inference pipelines, and manage ComfyUI nodes for Stable Diffusion and other generative models.
skill_view("comfyui")
📖 Guide
Load with skill_view("comfyui"). Requires ComfyUI installed (local or remote). The skill handles workflow loading, node configuration, and output management.
🔧 How To
For image generation: load a checkpoint → configure sampler → write prompt → queue. The skill can automate multi-step pipelines with custom node workflows.
⚠️ Pitfalls
Requires a GPU for practical use. ComfyUI node graph can be complex — the skill helps with standard workflows. Model download space needed (2-7GB per model).
Author, validate, and export Google-style DESIGN.md token spec files. Structured design documentation for AI-assisted development.
skill_view("design-md")
📖 Guide
Load with skill_view("design-md"). Follows Google's DESIGN.md specification format with token-level design breakdown for AI development agents.
🔧 How To
For a new feature: write DESIGN.md with problem statement, proposed solution, interface tokens, and implementation notes. The skill validates against the schema and exports clean markdown.
⚠️ Pitfalls
Relatively new format — not widely adopted outside Google-adjacent projects. May not fit all project documentation styles.
Create hand-drawn style diagrams as Excalidraw JSON files. Supports architecture diagrams, flowcharts, sequence diagrams — exported as .excalidraw files for import into excalidraw.com.
★ Featuredv1.3.0
skill_view("excalidraw")
📖 Guide
Load with skill_view("excalidraw"). Describe the diagram you want. The skill generates Excalidraw JSON that renders with the signature hand-drawn aesthetic.
🔧 How To
For an architecture diagram: describe components and connections → the skill generates positioned elements with connectors → open the JSON in excalidraw.com to view and edit.
⚠️ Pitfalls
Excalidraw JSON is not human-readable — always open in the editor to verify. Complex layouts may need manual adjustment after generation.
Rewrite AI-generated text to sound more natural and human. Strips AI-isms, adds authentic voice, adjusts tone, and makes content read like a real person wrote it.
v1.1.0
skill_view("humanizer")
📖 Guide
Load with skill_view("humanizer"). Paste AI-generated text — the skill analyzes it for common AI patterns (hedging, formulaic transitions, over-explaining) and rewrites with natural voice.
🔧 How To
For blog posts: provide the raw AI draft → specify desired tone (professional, casual, humorous) → the skill outputs rewritten text with authentic voice and varied sentence structure.
⚠️ Pitfalls
Stripping AI-isms too aggressively can lose clarity. Works best post-edit — run multiple passes for fine-tuning. Style preferences should be communicated upfront.
Generate project ideas via creative constraints. Uses structured brainstorming techniques to produce novel, specific, and actionable project concepts.
skill_view("ideation")
📖 Guide
Load with skill_view("ideation"). Provide a domain or problem space. The skill applies creative constraint frameworks (SCAMPER, random input, reversal) to generate unexpected ideas.
🔧 How To
Describe your domain (e.g., "developer tools for note-taking") → the skill generates 5-10 specific project ideas with different angles, business models, and technical approaches.
⚠️ Pitfalls
Ideas need human validation — the skill generates possibilities, not verified solutions. Best used as a brainstorming partner, not a decision maker.
Create mathematical and algorithmic animations using Manim Community Edition. 3Blue1Brown-style explanatory videos with geometric animations, equation rendering, and scene scripting.
skill_view("manim-video")
📖 Guide
Load with skill_view("manim-video"). Write Manim scene scripts in Python. The skill handles scene construction, animation timing, and video rendering.
🔧 How To
For an algorithm visualization: describe the algorithm → the skill generates Manim scene code with step-by-step animations → render with "manim -pql scene.py SceneName".
⚠️ Pitfalls
Manim rendering is GPU-accelerated but still slow — expect minutes per scene. Requires Cairo, FFmpeg, and system dependencies. Output quality depends heavily on scene script complexity.
Create interactive p5.js sketches — generative art, shaders, interactive visualizations, and 3D graphics. Runs in the browser as self-contained HTML pages.
skill_view("p5js")
📖 Guide
Load with skill_view("p5js"). Describe the visual you want. The skill generates a complete HTML page with embedded p5.js sketch using the global mode or instance mode.
🔧 How To
For generative art: describe patterns, colors, and motion → the skill writes the sketch with p5.js setup/draw loop → open in browser to see it animate. Supports mouse and keyboard interaction.
⚠️ Pitfalls
p5.js is 2D-focused — 3D (WEBGL) works but has limitations. Performance degrades with very large particle counts (>10k). Browser must support WebGL for 3D mode.
Create pixel art with era-authentic palettes — NES (52 colors), Game Boy (4 shades), PICO-8 (16 colors). Output as PNG with proper scaling.
skill_view("pixel-art")
📖 Guide
Load with skill_view("pixel-art"). Describe the sprite or scene and choose a palette era. The skill generates pixel-perfect PNG output at the appropriate resolution.
🔧 How To
For a game sprite: describe the character (e.g., "16×16 red mage with staff") → choose palette (NES/GB/PICO-8) → the skill outputs a properly scaled PNG with palette-constrained colors.
⚠️ Pitfalls
Pixel art at small sizes (8×8, 16×16) requires clear descriptions. Complex scenes may need larger canvases. Palettes are strictly limited to era-appropriate colors.
Access 54 real design system templates from Stripe, Linear, Vercel, Supabase, Tailwind CSS, and more. Use as starting points for HTML/CSS projects.
★ Featuredv2.0.0
skill_view("popular-web-designs")
📖 Guide
Load with skill_view("popular-web-designs"). Browse the available designs — each is a complete, production-quality HTML/CSS artifact inspired by a real company's design system.
🔧 How To
Pick a design style (e.g., Linear: clean dark theme with pill buttons) → the skill generates a starter HTML page with that design language → customize colors, content, and layout.
⚠️ Pitfalls
Designs are inspied by real companies but are not exact replicas. Some interactive features (modals, dropdowns) need JavaScript not included in the base template.
Throwaway HTML mockups — create 2-3 design variants to compare. Quick visual brainstorming for UI ideas without any build tooling.
skill_view("sketch")
📖 Guide
Load with skill_view("sketch"). Describe the UI you need. The skill generates 2-3 divergent design variants as standalone HTML files for side-by-side comparison.
🔧 How To
For a dashboard layout: describe the data and actions → the skill generates 3 visual approaches (card-based, list-based, chart-focused) → compare and choose.
⚠️ Pitfalls
Mockups are throwaway by design — not meant for production. No build system, no framework. CSS is inline or in <style> tags for portability.
Songwriting craft guidance and Suno AI music prompts. Generate lyrics, chord progressions, and Suno-optimized prompts for AI music generation.
skill_view("songwriting")
📖 Guide
Load with skill_view("songwriting-and-ai-music"). For lyrics: describe theme, mood, and genre. For Suno: the skill generates structured prompts with style tags, lyrics, and structure markers.
🔧 How To
For Suno: describe the desired genre, mood, and lyrical theme → the skill outputs a prompt with proper Suno syntax (style tags, section markers) → paste into Suno to generate.
⚠️ Pitfalls
AI music quality varies by platform and prompt. Suno prompts need specific formatting (genre: ..., lyrics: [[verse]] ...). Copyright considerations apply for commercial use.
Scaffold a static tutorial blog about a technical tool. Complete setup with posts, navigation, dark theme, and deployment config.
skill_view("tutorial-site-builder")
📖 Guide
Load with skill_view("tutorial-site-builder") for simplified scaffolding. For the full Hermes blog workflow, use the tutorial-blog skill instead which covers SEO, GEO, and reference pages.
🔧 How To
Provide the tool name and topic scope → the skill scaffolds an Astro site with starter posts, tag pages, RSS, sitemap, and dark theme. One command to build: npm run build.
⚠️ Pitfalls
Simpler than the full tutorial-blog skill — omits JSON-LD, advanced GEO, and reference page patterns. Use tutorial-blog for production-quality sites.
Gmail, Calendar, Drive, Docs, and Sheets management via the gws CLI or direct Python integration. Read and manage Google services from the terminal.
skill_view("google-workspace")
📖 Guide
Load with skill_view("google-workspace"). Requires gws CLI or Google API credentials. Supports email search/send, calendar events, drive file management, and document editing.
🔧 How To
Gmail: list/search/read/send emails. Calendar: create/list/update events. Drive: list/upload/download files. Docs: read/edit Google Docs. Sheets: read/write cells and ranges.
⚠️ Pitfalls
Requires OAuth setup with Google Cloud project. Service account recommended for automation. API quotas apply (varies by service).
Manage Linear issues, projects, and teams via GraphQL API + curl. Issue lifecycle, project management, team operations, and workflow automation.
v1.2.0
skill_view("linear")
📖 Guide
Load with skill_view("linear"). Uses Linear's GraphQL API directly. Requires a Linear API key. Supports all major operations: issue CRUD, project management, team queries.
🔧 How To
Create issue: mutation with teamId, title, description, assignee. List issues: query with filters (status, assignee, project). Update: mutation with issue ID. Search: use filter nodes.
⚠️ Pitfalls
GraphQL syntax is specific to Linear's schema. API key must have appropriate scopes. Rate limits apply — batch operations when possible.
Geocoding, POI search, routing, and timezone lookup using OpenStreetMap and OSRM. Free, no API key needed for basic usage.
skill_view("maps")
📖 Guide
Load with skill_view("maps"). Uses OpenStreetMap Nominatim API for geocoding and OSRM for routing. All free and open-source.
🔧 How To
Geocode: "geocode San Francisco" → returns lat/lon and address. Route: "route from A to B" → returns distance, duration, and turn-by-turn. Search POI: "find coffee shops near X".
⚠️ Pitfalls
OSM data quality varies by region. Nominatim has usage limits (1 req/s). OSRM is best for driving routes — walking/cycling may be less optimal.
Edit PDF text, fix typos, update titles, and modify PDF metadata using natural language prompts. CLI-based PDF editing without layout rebuilding.
skill_view("nano-pdf")
📖 Guide
Load with skill_view("nano-pdf"). Uses nano-pdf CLI tool. Describe text changes in natural language — the tool finds and replaces text in PDF content.
🔧 How To
Fix a typo: "nano-pdf fix report.pdf --change \"recieve\" to \"receive\"". Update title: "nano-pdf meta report.pdf --title \"New Title\"". Add text: "nano-pdf add report.pdf --text \"DRAFT\" --page 1".
⚠️ Pitfalls
Works best with text-based PDFs — scanned PDFs (images) are not editable. Complex layout changes may not survive. Font substitution may alter appearance.
Notion API integration via curl — pages, databases, blocks, and search. Read, create, and update Notion content from the terminal.
v1.0.0
skill_view("notion")
📖 Guide
Load with skill_view("notion"). Uses Notion's REST API directly. Requires a Notion Integration token. Supports page CRUD, database queries, block management, and search.
🔧 How To
Read a page: GET /v1/pages/{id}. Query database: POST /v1/databases/{id}/query with filters. Create page: POST /v1/pages with parent and properties. Search: POST /v1/search.
⚠️ Pitfalls
Notion API is paginated (100 items/page). Rich text formatting uses Notion-specific block structure. Integration must be shared with specific pages — no blanket access.
Extract text from PDFs and scanned documents using PyMuPDF (text PDFs) and marker-pdf (scanned/image PDFs with OCR).
skill_view("ocr-and-documents")
📖 Guide
Load with skill_view("ocr-and-documents"). Uses pymupdf for text-based PDFs (fast) and marker-pdf for scanned documents (slower, OCR-based).
🔧 How To
For text PDFs: pymupdf extract text per page. For scanned: marker-pdf with OCR. The skill detects PDF type and chooses the optimal extraction method. Output as clean text or markdown.
⚠️ Pitfalls
OCR quality depends on scan resolution (300+ DPI recommended). Handwritten text has lower accuracy. Very long documents may hit processing time limits.
Create, read, edit .pptx presentations with python-pptx. Full slide management: add slides, text, tables, charts, images, and speaker notes.
skill_view("powerpoint")
📖 Guide
Load with skill_view("powerpoint"). Uses python-pptx library. Supports slide creation from templates, text formatting, table building, chart generation, and image insertion.
🔧 How To
Create a presentation: define slide structure → add content per slide (titles, bullet points, tables, charts) → add speaker notes → save as .pptx. Works with existing files for editing.
⚠️ Pitfalls
python-pptx cannot render or preview slides — must open in PowerPoint/Google Slides. Complex animations and transitions are not supported. Images must be local files.
Operate the Teams meeting summary pipeline via Hermes CLI. Fully automated pipeline: join meeting → transcribe → summarize → distribute.
skill_view("teams-meeting-pipeline")
📖 Guide
Load with skill_view("teams-meeting-pipeline"). Requires the teams_pipeline plugin enabled and Microsoft Graph API access.
🔧 How To
Trigger a pipeline run via the CLI. The pipeline joins the Teams meeting, captures captions, generates a summary, and posts it to configured destinations.
⚠️ Pitfalls
Requires Teams admin permissions. Pipeline has persistent state — ensure clean state between runs. Transcript accuracy depends on meeting audio quality.
Research and security testing — techniques for understanding LLM safety boundaries. Includes Parseltongue, GODMODE, and ULTRAPLINIAN patterns for academic red-teaming.
skill_view("godmode")
📖 Guide
Load with skill_view("godmode"). For authorized security research only. Documents known jailbreak patterns for understanding model safety boundaries.
🔧 How To
Academic use only. Documented patterns help understand how models can be exploited, which informs better safety training and guardrails.
⚠️ Pitfalls
⚠️ For authorized research only. Many techniques are patched in modern models. Using these on production systems without authorization may violate ToS.
Search arXiv papers by keyword, author, category, or ID. Get paper details, abstracts, and download links.
v1.0.0
skill_view("arxiv")
📖 Guide
Load with skill_view("arxiv"). Uses the arXiv API directly. Search by keyword, author (au:), category (cat:), or paper ID.
🔧 How To
Search: "search arxiv for reinforcement learning agents" → returns recent papers with titles, authors, abstracts, and PDF links. Filter by category: "cat:cs.AI". Author search: "au:John_Doe".
⚠️ Pitfalls
arXiv API returns limited fields (title, abstract, authors). Full text requires PDF download. Rate limits: 1 request per 3 seconds for non-commercial use.
Karpathy's LLM Wiki pattern — build and query an interlinked markdown knowledge base for personal research and learning.
skill_view("llm-wiki")
📖 Guide
Load with skill_view("llm-wiki"). Inspired by Karpathy's approach. Build a personal wiki from research notes, with cross-references and full-text search.
🔧 How To
Create markdown notes for each topic → link between notes with [[wiki-links]] → search across all notes. The skill helps structure research and maintain connections between related concepts.
⚠️ Pitfalls
Wiki-links are convention-based — no automatic graph view unless using Obsidian. Content quality depends on note-writing discipline.
Research and verify API pricing, free tier availability, rate limits, and model capabilities across LLM providers.
skill_view("model-pricing-research")
📖 Guide
Load with skill_view("model-pricing-research"). Checks provider pricing pages, compares costs per token, identifies free tiers, and verifies model availability.
🔧 How To
For a comparison: name the models/providers → the skill fetches current pricing → produces a comparison table with cost per 1M tokens, context windows, and capabilities.
⚠️ Pitfalls
Pricing changes frequently — results may be stale. Some providers have complex pricing (tiered, cached tokens, batch discounts). Always verify on the provider's site.
Query Polymarket prediction markets — see market prices, orderbooks, trade history, and market details.
skill_view("polymarket")
📖 Guide
Load with skill_view("polymarket"). Uses Polymarket's API or CLOB API. Query markets by category, search terms, or specific market IDs.
🔧 How To
Search markets: "what are the prediction markets for AI regulation" → returns current markets with prices, volume, and closing dates. Check a market: get orderbook and resolution criteria.
⚠️ Pitfalls
Requires internet access. Polymarket uses USDC — prices shown are in USDC, not USD. Market resolution depends on designated reporters.
Control Philips Hue lights, scenes, and rooms via OpenHue CLI. Turn lights on/off, set brightness, change colors, and activate scenes.
skill_view("openhue")
📖 Guide
Load with skill_view("openhue"). Requires OpenHue CLI installed and a Hue Bridge on the local network. Uses the Hue local API — no cloud dependency.
🔧 How To
Control lights: "open hue lights set LivingRoom --on --bri 254 --hue 46920". Scenes: "open hue scenes activate Relax". Rooms: "open hue groups set All --on".
⚠️ Pitfalls
Requires physical Hue Bridge. Initial setup needs bridge discovery and link button press. Local network access only — no remote control.
Post, search, DM, and manage media on X/Twitter via xurl CLI. Full v2 API support for tweets, threads, DMs, and account management.
skill_view("xurl")
📖 Guide
Load with skill_view("xurl"). Requires xurl CLI installed. Uses X API v2 with OAuth 2.0. Supports tweet posting with media, threads, search, DMs, and account queries.
Build catalog/directory pages with search, category filters, and card grids — like the tools, plugins, gateway, and hosting pages on this blog.
v1.1.0
skill_view("build-reference-page")
📖 Guide
Load with skill_view("build-reference-page"). Two-file pattern: data file (src/data/<name>.ts) + page (src/pages/<name>/index.astro). Uses addEventListener (never inline onclick) for filter/search.
🔧 How To
Create a data file with typed entries → create the page with search input, filter buttons, and card grid → each card has data-category, data-name, data-desc for JS filtering. Follows the existing 6-page pattern.
⚠️ Pitfalls
Astro <script> tags are ES modules — always use addEventListener. Never use inline onclick/oninput. Read the existing plugin/tools pages for exact reference.
Load with skill_view("hermes-agent-skill-authoring"). Covers YAML frontmatter schema, body structure, validator checks, and proper skill organization.
🔧 How To
Create a skill: define frontmatter (name, description, version) → write structured markdown body with Overview, When to Use, Step-by-Step, Pitfalls, and Verification Checklist → save as SKILL.md.
⚠️ Pitfalls
Frontmatter YAML must be valid. Skills are procedural knowledge, not data storage. Related skills should be cross-referenced.
Debug Node.js applications via --inspect flag and Chrome DevTools Protocol CLI. Inspect heap, CPU profiles, breakpoints, and async stacks.
skill_view("node-inspect-debugger")
📖 Guide
Load with skill_view("node-inspect-debugger"). Start Node with --inspect flag → connect via Chrome DevTools or CLI inspector → set breakpoints, inspect variables, profile performance.
--inspect exposes a debugging port — not for production. Use --inspect=127.0.0.1 to restrict to localhost. Node 18+ required for latest inspector features.
Write markdown plans to .hermes/plans/ without executing anything. Pure planning mode for architecture design and implementation strategy.
v1.0.0
skill_view("plan")
📖 Guide
Load with skill_view("plan"). When asked to design/architect/plan only — the skill writes a detailed plan document to .hermes/plans/ without making any code changes.
🔧 How To
For architecture planning: describe the problem → the skill produces a plan with tasks, paths, estimated effort, and code snippets. No files are modified — just a plan document.
⚠️ Pitfalls
Plans are static documents — they don't auto-update as implementation progresses. Use writing-plans skill for plans that include coding tasks.
Debug Python code with pdb REPL and debugpy remote debugging (DAP protocol). Set breakpoints, inspect variables, and debug remotely.
skill_view("python-debugpy")
📖 Guide
Load with skill_view("python-debugpy"). For pdb: add import pdb; pdb.set_trace() in code. For debugpy: configure VS Code/pycharm for remote debugging via DAP.
🔧 How To
Quick debug: add breakpoint() in Python 3.7+ → run code → interactive pdb at the breakpoint. Remote: start debugpy server → connect from IDE → full DAP debugging.
⚠️ Pitfalls
pdb doesn't work in headless terminal environments without PTY. debugpy requires port access. Some async code is harder to debug with pdb.
Load with skill_view("requesting-code-review"). Runs a multi-stage review: security scan (SAST patterns), quality checks (linting, type checking), and generates a review report.
🔧 How To
Before committing: run the review on your changes → fix flagged issues (security, quality, style) → commit with confidence. The skill can auto-fix some issues.
⚠️ Pitfalls
Not a replacement for human code review. Security scanning is pattern-based — may miss novel vulnerabilities. Auto-fixes should be reviewed before applying.
Post-task reflection cycle. After every complex task, analyze mistakes, apply user corrections, and encode lessons as skills or memory.
skill_view("self-critique-loop")
📖 Guide
Load with skill_view("self-critique-loop"). Must be loaded after every complex task (5+ tool calls, user correction, or tool error). Runs a structured reflection cycle.
🔧 How To
After task completion: review what went wrong → identify root causes → encode fixes as skill patches or memory updates → prevent repeat mistakes. The primary intelligence-compounding mechanism.
⚠️ Pitfalls
Requires honesty about mistakes. Skip for simple/mechanical tasks — only for complex or corrected work. Don't over-reflect on trivial issues.
Throwaway experiments to validate an idea before building. Quick prototypes to test feasibility, performance, or approach.
skill_view("spike")
📖 Guide
Load with skill_view("spike"). For validating uncertain approaches. Create minimal prototypes, test hypotheses, and produce findings — not production code.
🔧 How To
Define the question you're trying to answer → build the minimal prototype to validate → collect results → decide go/no-go. Spikes are throwaway by design.
⚠️ Pitfalls
Spikes are not production code — don't try to reuse them. Time-box the spike (recommend 1-2 hours max). Document findings before discarding the code.
Execute implementation plans via delegate_task subagents with a two-stage review process. Decompose work, parallelize, and verify.
v1.0.0
skill_view("subagent-driven-development")
📖 Guide
Load with skill_view("subagent-driven-development"). Uses delegate_task to spawn subagents for parallel implementation. Two-stage review: first subagent checks second subagent's work.
🔧 How To
Take a plan with multiple tasks → launch parallel subagents (up to 3) → each implements their task → results are cross-reviewed → merge accepted implementations.
⚠️ Pitfalls
Subagents have no memory of your conversation — pass all context explicitly. Parallel execution max 3 children. Verify outputs independently — subagents can hallucinate success.
4-phase root cause debugging: understand the bug before fixing. Reproduce → isolate → identify root cause → fix with verification.
★ Featuredv1.2.0
skill_view("systematic-debugging")
📖 Guide
Load with skill_view("systematic-debugging"). Four phases: (1) Understand the symptom, (2) Reproduce reliably, (3) Isolate the minimal reproducing case, (4) Identify root cause and fix.
🔧 How To
When a bug is reported: reproduce it first → simplify to minimal case → identify root cause (not symptom) → fix with tests → verify. Never skip to fixing without understanding.
⚠️ Pitfalls
Resist the urge to fix symptoms. Without reproduction, you can't verify the fix. Check related code for similar patterns. Add tests that would have caught the bug.
Red-Green-Refactor TDD cycle. Write tests before code, make them pass, then refactor. Enforces test-first discipline.
★ Featuredv1.3.0
skill_view("test-driven-development")
📖 Guide
Load with skill_view("test-driven-development"). Strict RED-GREEN-REFACTOR cycle: write failing test first → implement minimal code to pass → refactor while keeping tests green.
🔧 How To
RED: write a test that captures the desired behavior (will fail). GREEN: write just enough code to pass. REFACTOR: clean up while tests stay green. Repeat for each feature increment.
⚠️ Pitfalls
Harder for UI/visual components. Tests for trivial code add maintenance burden. Mock external dependencies to avoid flaky tests.
Full tutorial blog workflow — scaffold, theme, SEO/GEO optimization, JSON-LD structured data, reference pages, and Cloudflare deployment.
★ Featuredv2.2.0
skill_view("tutorial-blog")
📖 Guide
Load with skill_view("tutorial-blog"). Complete Astro blog setup with dark theme, MDX posts, SEO/GEO optimization, JSON-LD structured data, interactive reference pages, and deployment.
🔧 How To
Scaffold with Astro blog template → customize theme (colors, fonts, layout) → write MDX posts with TLDR, FAQ, and internal links → add JSON-LD schema → add reference pages → deploy to Cloudflare Pages.
⚠️ Pitfalls
Astro <script> tags are ES modules — always use addEventListener. JSON-LD must use set:html directive. Description limit 160 chars enforced by schema.
Write implementation plans with bite-sized tasks, file paths, and estimated code. Structured planning before execution.
skill_view("writing-plans")
📖 Guide
Load with skill_view("writing-plans"). Produces a markdown plan with task breakdown, file paths, estimated effort, and implementation order.
🔧 How To
For a feature: describe what needs to be built → the skill creates a plan with sequential tasks, each specifying files to modify, what code to write, and verification steps.
⚠️ Pitfalls
Plans assume ideal conditions — real implementation may diverge. Update the plan if discoveries change the approach. Tasks should be independently testable.