From 1c9433897c7b8a3b2754a84875e8f86d0a42991a Mon Sep 17 00:00:00 2001 From: teknium1 <127238744+teknium1@users.noreply.github.com> Date: Sat, 8 Aug 2026 14:28:17 -0700 Subject: [PATCH] =?UTF-8?q?chore(skills):=20standards=20sweep=20=E2=80=94?= =?UTF-8?q?=20bring=2042=20bundled/optional=20skills=20up=20to=20hardline?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Audited all 191 in-repo skills (77 bundled, 114 optional) against the authoring standards (AGENTS.md hardline + PR #80800). Fixed 42: - 8 overlong descriptions rewritten to <= 60 chars, one sentence, period (one-three-one-rule 525ch, drug-discovery 405ch, web-pentest 358ch, fitness-nutrition 352ch, neuroskill-bci 332ch, oss-forensics 320ch, computer-use 307ch, memento-flashcards 252ch) - 24 skills with missing frontmatter fields: author (credited from git history: f-trycua, SHL0MS, teyrebaz33, haileymarshall, FurkanL0, teknium1), license, version, platforms, tags - 7 machine-local paths scrubbed (/home/bb, /home/user, /home/ubuntu -> portable placeholders) - 11 marketing-word intros reworded (Comprehensive/state-of-the-art) - docs catalogs + per-skill pages regenerated, scope-disciplined Deferred (not in this PR): - 14 frontmatter/dir name mismatches — open PR #42788 already proposes the dir-rename approach for 4 of them; resolve there as one class - 2 skills over 100k chars (pytorch-fsdp 159k, research-paper-writing 103k) — need content splits into references/, separate PRs - comfyui dangling related_skill resolves after the name-mismatch class --- .../communication/one-three-one-rule/SKILL.md | 9 +- .../audiocraft-audio-generation/SKILL.md | 2 +- optional-skills/creative/blender-mcp/SKILL.md | 1 + optional-skills/creative/heartmula/SKILL.md | 2 + optional-skills/devops/actual-setup/SKILL.md | 1 + optional-skills/email/agentmail/SKILL.md | 2 + optional-skills/finance/polymarket/SKILL.md | 1 + .../gaming/minecraft-modpack-server/SKILL.md | 3 + .../gaming/pokemon-player/SKILL.md | 3 + .../health/fitness-nutrition/SKILL.md | 8 +- .../health/neuroskill-bci/SKILL.md | 7 +- optional-skills/mlops/lambda-labs/SKILL.md | 4 +- optional-skills/mlops/modal/SKILL.md | 2 +- .../models/segment-anything-model/SKILL.md | 2 +- optional-skills/mlops/pytorch-fsdp/SKILL.md | 2 +- .../mlops/stable-diffusion/SKILL.md | 2 +- optional-skills/mlops/tensorrt-llm/SKILL.md | 2 +- .../mlops/training/axolotl/SKILL.md | 2 +- .../mlops/training/unsloth/SKILL.md | 4 +- .../productivity/memento-flashcards/SKILL.md | 6 +- .../research/bioinformatics/SKILL.md | 2 + .../research/domain-intel/SKILL.md | 7 + .../research/drug-discovery/SKILL.md | 8 +- .../research/osint-investigation/SKILL.md | 1 + .../security/oss-forensics/SKILL.md | 13 +- optional-skills/security/web-pentest/SKILL.md | 14 +- .../software-development/code-wiki/SKILL.md | 2 +- .../rest-graphql-debug/SKILL.md | 1 + optional-skills/yuanbao/SKILL.md | 2 + .../computer-use/SKILL.md | 9 +- skills/creative/ascii-video/SKILL.md | 7 + skills/creative/manim-video/SKILL.md | 6 + skills/creative/p5js/SKILL.md | 2 + .../songwriting-and-ai-music/SKILL.md | 3 + skills/media/youtube-content/SKILL.md | 7 + skills/note-taking/obsidian/SKILL.md | 7 + skills/productivity/google-workspace/SKILL.md | 2 +- .../teams-meeting-pipeline/SKILL.md | 1 + skills/research/llm-wiki/SKILL.md | 2 +- skills/software-development/dogfood/SKILL.md | 2 + .../node-inspect-debugger/SKILL.md | 4 +- .../python-debugpy/SKILL.md | 4 +- .../docs/reference/optional-skills-catalog.md | 15 +- website/docs/reference/skills-catalog.md | 2 +- .../autonomous-ai-agents-computer-use.md | 79 +++++++-- .../bundled/creative/creative-ascii-video.md | 4 + .../bundled/creative/creative-manim-video.md | 3 + .../skills/bundled/creative/creative-p5js.md | 2 + .../creative-songwriting-and-ai-music.md | 3 + .../bundled/media/media-youtube-content.md | 4 + .../note-taking/note-taking-obsidian.md | 4 + .../productivity-google-workspace.md | 2 +- .../productivity-teams-meeting-pipeline.md | 1 + .../bundled/research/research-llm-wiki.md | 2 +- .../software-development-dogfood.md | 2 + ...tware-development-node-inspect-debugger.md | 4 +- .../software-development-python-debugpy.md | 20 +-- .../communication-one-three-one-rule.md | 6 +- .../creative-audiocraft-audio-generation.md | 2 +- .../optional/creative/creative-blender-mcp.md | 1 + .../optional/creative/creative-heartmula.md | 2 + .../optional/devops/devops-actual-setup.md | 164 ++++++++++++++++++ .../skills/optional/email/email-agentmail.md | 2 + .../optional/finance/finance-polymarket.md | 1 + .../gaming/gaming-minecraft-modpack-server.md | 3 + .../optional/gaming/gaming-pokemon-player.md | 14 +- .../health/health-fitness-nutrition.md | 7 +- .../optional/health/health-neuroskill-bci.md | 6 +- .../optional/mlops/mlops-lambda-labs.md | 4 +- .../skills/optional/mlops/mlops-modal.md | 2 +- .../mlops-models-segment-anything-model.md | 2 +- .../optional/mlops/mlops-pytorch-fsdp.md | 2 +- .../optional/mlops/mlops-stable-diffusion.md | 2 +- .../optional/mlops/mlops-tensorrt-llm.md | 2 +- .../optional/mlops/mlops-training-axolotl.md | 2 +- .../optional/mlops/mlops-training-unsloth.md | 4 +- .../productivity-memento-flashcards.md | 6 +- .../research/research-bioinformatics.md | 2 + .../research/research-domain-intel.md | 4 + .../research/research-drug-discovery.md | 6 +- .../research/research-osint-investigation.md | 1 + .../security/security-oss-forensics.md | 13 +- .../optional/security/security-web-pentest.md | 14 +- .../software-development-code-wiki.md | 2 +- ...software-development-rest-graphql-debug.md | 1 + .../optional/yuanbao/yuanbao-yuanbao.md | 2 + website/sidebars.ts | 1 + 87 files changed, 444 insertions(+), 154 deletions(-) create mode 100644 website/docs/user-guide/skills/optional/devops/devops-actual-setup.md diff --git a/optional-skills/communication/one-three-one-rule/SKILL.md b/optional-skills/communication/one-three-one-rule/SKILL.md index 3c7b4163af..032b2140a7 100644 --- a/optional-skills/communication/one-three-one-rule/SKILL.md +++ b/optional-skills/communication/one-three-one-rule/SKILL.md @@ -1,13 +1,6 @@ --- name: one-three-one-rule -description: > - Structured decision-making framework for technical proposals and trade-off analysis. - When the user faces a choice between multiple approaches (architecture decisions, - tool selection, refactoring strategies, migration paths), this skill produces a - 1-3-1 format: one clear problem statement, three distinct options with pros/cons, - and one concrete recommendation with definition of done and implementation plan. - Use when the user asks for a "1-3-1", says "give me options", or needs help - choosing between competing approaches. +description: "1-3-1 decision briefs: problem, three options, one pick." platforms: [linux, macos, windows] version: 1.0.0 author: Willard Moore diff --git a/optional-skills/creative/audiocraft-audio-generation/SKILL.md b/optional-skills/creative/audiocraft-audio-generation/SKILL.md index 12b4645581..be5075c2f2 100644 --- a/optional-skills/creative/audiocraft-audio-generation/SKILL.md +++ b/optional-skills/creative/audiocraft-audio-generation/SKILL.md @@ -15,7 +15,7 @@ metadata: # AudioCraft: Audio Generation -Comprehensive guide to using Meta's AudioCraft for text-to-music and text-to-audio generation with MusicGen, AudioGen, and EnCodec. +Guide to using Meta's AudioCraft for text-to-music and text-to-audio generation with MusicGen, AudioGen, and EnCodec. ## When to use AudioCraft diff --git a/optional-skills/creative/blender-mcp/SKILL.md b/optional-skills/creative/blender-mcp/SKILL.md index a689ac6373..7221bc89b5 100644 --- a/optional-skills/creative/blender-mcp/SKILL.md +++ b/optional-skills/creative/blender-mcp/SKILL.md @@ -4,6 +4,7 @@ description: Drive Blender via the catalog blender MCP, with bpy recipes. version: 2.1.0 requires: Blender 3.0+ desktop instance (headless via xvfb-run) author: alireza78a + kshitijk4poor + Hermes Agent +license: MIT tags: [blender, 3d, animation, modeling, bpy, mcp] platforms: [linux, macos, windows] --- diff --git a/optional-skills/creative/heartmula/SKILL.md b/optional-skills/creative/heartmula/SKILL.md index df534b4347..9ecd6a276a 100644 --- a/optional-skills/creative/heartmula/SKILL.md +++ b/optional-skills/creative/heartmula/SKILL.md @@ -2,6 +2,8 @@ name: heartmula description: "HeartMuLa: Suno-like song generation from lyrics + tags." version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos, windows] metadata: hermes: diff --git a/optional-skills/devops/actual-setup/SKILL.md b/optional-skills/devops/actual-setup/SKILL.md index ae0fb98b29..42521ca71d 100644 --- a/optional-skills/devops/actual-setup/SKILL.md +++ b/optional-skills/devops/actual-setup/SKILL.md @@ -4,6 +4,7 @@ description: Set up Actual Computer (actual.inc) inference in Hermes. version: 2.0.0 author: shl0ms + Hermes Agent license: MIT +platforms: [linux, macos, windows] metadata: hermes: tags: [actual, actual-inc, provider, local-inference, relay, gguf, setup] diff --git a/optional-skills/email/agentmail/SKILL.md b/optional-skills/email/agentmail/SKILL.md index 54baaf3882..770ca8d551 100644 --- a/optional-skills/email/agentmail/SKILL.md +++ b/optional-skills/email/agentmail/SKILL.md @@ -2,6 +2,8 @@ name: agentmail description: "Give the agent its own inbox: send and receive email." version: 1.0.0 +author: teyrebaz33, Hermes Agent +license: MIT platforms: [linux, macos, windows] metadata: hermes: diff --git a/optional-skills/finance/polymarket/SKILL.md b/optional-skills/finance/polymarket/SKILL.md index 6913e48729..aa25382639 100644 --- a/optional-skills/finance/polymarket/SKILL.md +++ b/optional-skills/finance/polymarket/SKILL.md @@ -3,6 +3,7 @@ name: polymarket description: "Query Polymarket: markets, prices, orderbooks, history." version: 1.0.0 author: Hermes Agent + Teknium +license: MIT tags: [polymarket, prediction-markets, market-data, trading] platforms: [linux, macos, windows] --- diff --git a/optional-skills/gaming/minecraft-modpack-server/SKILL.md b/optional-skills/gaming/minecraft-modpack-server/SKILL.md index 0164f7ed9b..23f8822414 100644 --- a/optional-skills/gaming/minecraft-modpack-server/SKILL.md +++ b/optional-skills/gaming/minecraft-modpack-server/SKILL.md @@ -1,6 +1,9 @@ --- name: minecraft-modpack-server description: "Host modded Minecraft servers (CurseForge, Modrinth)." +version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT tags: [minecraft, gaming, server, neoforge, forge, modpack] platforms: [linux, macos] --- diff --git a/optional-skills/gaming/pokemon-player/SKILL.md b/optional-skills/gaming/pokemon-player/SKILL.md index 0e4207e334..6da6584e34 100644 --- a/optional-skills/gaming/pokemon-player/SKILL.md +++ b/optional-skills/gaming/pokemon-player/SKILL.md @@ -1,6 +1,9 @@ --- name: pokemon-player description: "Play Pokemon via headless emulator + RAM reads." +version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT tags: [gaming, pokemon, emulator, pyboy, gameplay, gameboy] platforms: [linux, macos, windows] --- diff --git a/optional-skills/health/fitness-nutrition/SKILL.md b/optional-skills/health/fitness-nutrition/SKILL.md index c1c15a6f4f..561a44d5e8 100644 --- a/optional-skills/health/fitness-nutrition/SKILL.md +++ b/optional-skills/health/fitness-nutrition/SKILL.md @@ -1,13 +1,9 @@ --- name: fitness-nutrition -description: > - Gym workout planner and nutrition tracker. Search 690+ exercises by muscle, - equipment, or category via wger. Look up macros and calories for 380,000+ - foods via USDA FoodData Central. Compute BMI, TDEE, one-rep max, macro - splits, and body fat — pure Python, no pip installs. Built for anyone - chasing gains, cutting weight, or just trying to eat better. +description: "Workout planning, macros, and body metrics via wger/USDA." platforms: [linux, macos, windows] version: 1.0.0 +author: Hailey Marshall (haileymarshall), Hermes Agent authors: - haileymarshall license: MIT diff --git a/optional-skills/health/neuroskill-bci/SKILL.md b/optional-skills/health/neuroskill-bci/SKILL.md index da6e6b2e4c..d16325abdd 100644 --- a/optional-skills/health/neuroskill-bci/SKILL.md +++ b/optional-skills/health/neuroskill-bci/SKILL.md @@ -1,11 +1,6 @@ --- name: neuroskill-bci -description: > - Connect to a running NeuroSkill instance and incorporate the user's real-time - cognitive and emotional state (focus, relaxation, mood, cognitive load, drowsiness, - heart rate, HRV, sleep staging, and 40+ derived EXG scores) into responses. - Requires a BCI wearable (Muse 2/S or OpenBCI) and the NeuroSkill desktop app - running locally. +description: "Use live BCI cognitive and mood state from NeuroSkill." platforms: [linux, macos, windows] version: 1.0.0 author: Hermes Agent + Nous Research diff --git a/optional-skills/mlops/lambda-labs/SKILL.md b/optional-skills/mlops/lambda-labs/SKILL.md index 742e7086fc..e324cca267 100644 --- a/optional-skills/mlops/lambda-labs/SKILL.md +++ b/optional-skills/mlops/lambda-labs/SKILL.md @@ -14,7 +14,7 @@ metadata: # Lambda Labs GPU Cloud -Comprehensive guide to running ML workloads on Lambda Labs GPU cloud with on-demand instances and 1-Click Clusters. +Guide to running ML workloads on Lambda Labs GPU cloud with on-demand instances and 1-Click Clusters. ## When to use Lambda Labs @@ -286,7 +286,7 @@ Filesystems must be attached at instance launch time: └── outputs/ # Local SSD (faster, ephemeral) -/home/ubuntu/ +~/ (instance home) └── working/ # Temporary files ``` diff --git a/optional-skills/mlops/modal/SKILL.md b/optional-skills/mlops/modal/SKILL.md index 66d754fdc6..56e738baa5 100644 --- a/optional-skills/mlops/modal/SKILL.md +++ b/optional-skills/mlops/modal/SKILL.md @@ -14,7 +14,7 @@ metadata: # Modal Serverless GPU -Comprehensive guide to running ML workloads on Modal's serverless GPU cloud platform. +Guide to running ML workloads on Modal's serverless GPU cloud platform. ## When to use Modal diff --git a/optional-skills/mlops/models/segment-anything-model/SKILL.md b/optional-skills/mlops/models/segment-anything-model/SKILL.md index 765176d9c1..c1cd4272f5 100644 --- a/optional-skills/mlops/models/segment-anything-model/SKILL.md +++ b/optional-skills/mlops/models/segment-anything-model/SKILL.md @@ -14,7 +14,7 @@ metadata: # Segment Anything Model (SAM) -Comprehensive guide to using Meta AI's Segment Anything Model for zero-shot image segmentation. +Guide to using Meta AI's Segment Anything Model for zero-shot image segmentation. ## When to use SAM diff --git a/optional-skills/mlops/pytorch-fsdp/SKILL.md b/optional-skills/mlops/pytorch-fsdp/SKILL.md index 0436133e34..c4aecfa679 100644 --- a/optional-skills/mlops/pytorch-fsdp/SKILL.md +++ b/optional-skills/mlops/pytorch-fsdp/SKILL.md @@ -14,7 +14,7 @@ metadata: # Pytorch-Fsdp Skill -Comprehensive assistance with pytorch-fsdp development, generated from official documentation. +Assistance with pytorch-fsdp development, generated from official documentation. ## When to Use This Skill diff --git a/optional-skills/mlops/stable-diffusion/SKILL.md b/optional-skills/mlops/stable-diffusion/SKILL.md index 4c84733e90..bb97c47dc2 100644 --- a/optional-skills/mlops/stable-diffusion/SKILL.md +++ b/optional-skills/mlops/stable-diffusion/SKILL.md @@ -14,7 +14,7 @@ metadata: # Stable Diffusion Image Generation -Comprehensive guide to generating images with Stable Diffusion using the HuggingFace Diffusers library. +Guide to generating images with Stable Diffusion using the HuggingFace Diffusers library. ## When to use Stable Diffusion diff --git a/optional-skills/mlops/tensorrt-llm/SKILL.md b/optional-skills/mlops/tensorrt-llm/SKILL.md index c5785c64dc..272cc3b3f9 100644 --- a/optional-skills/mlops/tensorrt-llm/SKILL.md +++ b/optional-skills/mlops/tensorrt-llm/SKILL.md @@ -14,7 +14,7 @@ metadata: # TensorRT-LLM -NVIDIA's open-source library for optimizing LLM inference with state-of-the-art performance on NVIDIA GPUs. +NVIDIA's open-source library for optimizing LLM inference with high performance on NVIDIA GPUs. ## When to use TensorRT-LLM diff --git a/optional-skills/mlops/training/axolotl/SKILL.md b/optional-skills/mlops/training/axolotl/SKILL.md index 8b4297da06..513dea4ab5 100644 --- a/optional-skills/mlops/training/axolotl/SKILL.md +++ b/optional-skills/mlops/training/axolotl/SKILL.md @@ -18,7 +18,7 @@ metadata: 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. +Assistance with axolotl development, generated from official documentation. ## When to Use This Skill diff --git a/optional-skills/mlops/training/unsloth/SKILL.md b/optional-skills/mlops/training/unsloth/SKILL.md index dcadded527..1074fdb37c 100644 --- a/optional-skills/mlops/training/unsloth/SKILL.md +++ b/optional-skills/mlops/training/unsloth/SKILL.md @@ -14,7 +14,7 @@ metadata: # Unsloth Skill -Comprehensive assistance with unsloth development, generated from official documentation. +Assistance with unsloth development, generated from official documentation. ## When to Use This Skill @@ -33,7 +33,7 @@ This skill should be triggered when: ## Reference Files -This skill includes comprehensive documentation in `references/`: +This skill includes full documentation in `references/`: - **llms-txt.md** - Llms-Txt documentation diff --git a/optional-skills/productivity/memento-flashcards/SKILL.md b/optional-skills/productivity/memento-flashcards/SKILL.md index 40eb174d9e..a41252402b 100644 --- a/optional-skills/productivity/memento-flashcards/SKILL.md +++ b/optional-skills/productivity/memento-flashcards/SKILL.md @@ -1,10 +1,6 @@ --- name: memento-flashcards -description: >- - Spaced-repetition flashcard system. Create cards from facts or text, - chat with flashcards using free-text answers graded by the agent, - generate quizzes from YouTube transcripts, review due cards with - adaptive scheduling, and export/import decks as CSV. +description: "Spaced-repetition flashcards: create, review, quiz, export." version: 1.0.0 author: Memento AI license: MIT diff --git a/optional-skills/research/bioinformatics/SKILL.md b/optional-skills/research/bioinformatics/SKILL.md index 91da7ee8a9..07bc493a44 100644 --- a/optional-skills/research/bioinformatics/SKILL.md +++ b/optional-skills/research/bioinformatics/SKILL.md @@ -2,6 +2,8 @@ name: bioinformatics description: Gateway to 400+ genomics and computational biology skills. version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos] metadata: hermes: diff --git a/optional-skills/research/domain-intel/SKILL.md b/optional-skills/research/domain-intel/SKILL.md index 9f935348de..8d939b6487 100644 --- a/optional-skills/research/domain-intel/SKILL.md +++ b/optional-skills/research/domain-intel/SKILL.md @@ -1,7 +1,14 @@ --- name: domain-intel description: Passive recon of subdomains, SSL certs, WHOIS, and DNS. +version: 1.0.0 +author: FurkanL0, Hermes Agent +license: MIT platforms: [linux, macos, windows] +metadata: + hermes: + tags: [Domains, OSINT, DNS, Research] + related_skills: [] --- # Domain Intelligence — Passive OSINT diff --git a/optional-skills/research/drug-discovery/SKILL.md b/optional-skills/research/drug-discovery/SKILL.md index 1c5d0ce29a..64db7e91ec 100644 --- a/optional-skills/research/drug-discovery/SKILL.md +++ b/optional-skills/research/drug-discovery/SKILL.md @@ -1,12 +1,6 @@ --- name: drug-discovery -description: > - Pharmaceutical research assistant for drug discovery workflows. Search - bioactive compounds on ChEMBL, calculate drug-likeness (Lipinski Ro5, QED, - TPSA, synthetic accessibility), look up drug-drug interactions via - OpenFDA, interpret ADMET profiles, and assist with lead optimization. - Use for medicinal chemistry questions, molecule property analysis, clinical - pharmacology, and open-science drug research. +description: "Drug discovery: ChEMBL search, drug-likeness, interactions." platforms: [linux, macos, windows] version: 1.0.0 author: bennytimz diff --git a/optional-skills/research/osint-investigation/SKILL.md b/optional-skills/research/osint-investigation/SKILL.md index 4de5fb1901..0e35da9f85 100644 --- a/optional-skills/research/osint-investigation/SKILL.md +++ b/optional-skills/research/osint-investigation/SKILL.md @@ -4,6 +4,7 @@ description: Follow the money via public records and sanctions data. version: 0.1.0 platforms: [linux, macos, windows] author: Hermes Agent (adapted from ShinMegamiBoson/OpenPlanter, MIT) +license: MIT metadata: hermes: tags: [osint, investigation, public-records, sec, sanctions, corporate-registry, property, courts, due-diligence, journalism] diff --git a/optional-skills/security/oss-forensics/SKILL.md b/optional-skills/security/oss-forensics/SKILL.md index c06e0fc92c..048cebcf83 100644 --- a/optional-skills/security/oss-forensics/SKILL.md +++ b/optional-skills/security/oss-forensics/SKILL.md @@ -1,10 +1,9 @@ --- name: oss-forensics -description: | - Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories. - Covers deleted commit recovery, force-push detection, IOC extraction, multi-source evidence - collection, hypothesis formation/validation, and structured forensic reporting. - Inspired by RAPTOR's 1800+ line OSS Forensics system. +description: "GitHub supply-chain forensics: recovery, IOCs, reporting." +version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos, windows] category: security triggers: @@ -23,6 +22,10 @@ toolsets: - web - file - delegation +metadata: + hermes: + tags: [Security, Forensics, GitHub, Supply-Chain] + related_skills: [] --- # OSS Security Forensics Skill diff --git a/optional-skills/security/web-pentest/SKILL.md b/optional-skills/security/web-pentest/SKILL.md index 1ea82f8f0a..3ab758d174 100644 --- a/optional-skills/security/web-pentest/SKILL.md +++ b/optional-skills/security/web-pentest/SKILL.md @@ -1,11 +1,9 @@ --- name: web-pentest -description: | - Authorized web application penetration testing — reconnaissance, vulnerability - analysis, proof-based exploitation, and professional reporting. Adapts - Shannon's "No Exploit, No Report" methodology with hard guardrails for - scope, authorization, and aux-client leakage. Active testing against running - applications you own or have written authorization to test. +description: "Authorized web pentest: recon, proof-based exploits, report." +version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos] category: security triggers: @@ -22,6 +20,10 @@ toolsets: - browser - file - delegation +metadata: + hermes: + tags: [Security, Pentest, Web, Recon] + related_skills: [] --- # Web Application Penetration Testing diff --git a/optional-skills/software-development/code-wiki/SKILL.md b/optional-skills/software-development/code-wiki/SKILL.md index 93fde8a3d5..4b764ac658 100644 --- a/optional-skills/software-development/code-wiki/SKILL.md +++ b/optional-skills/software-development/code-wiki/SKILL.md @@ -13,7 +13,7 @@ metadata: # Code Wiki Skill -Generate a comprehensive wiki for any codebase — overview, architecture, per-module deep-dives, Mermaid class and sequence diagrams. Inspired by Google CodeWiki, but works on local repos, private repos, and any language. Uses only existing Hermes tools (`terminal`, `read_file`, `search_files`, `write_file`); no Docker, no external services, no extra dependencies. +Generate a full wiki for any codebase — overview, architecture, per-module deep-dives, Mermaid class and sequence diagrams. Inspired by Google CodeWiki, but works on local repos, private repos, and any language. Uses only existing Hermes tools (`terminal`, `read_file`, `search_files`, `write_file`); no Docker, no external services, no extra dependencies. This skill produces **reference documentation** (what/how). It does not produce strategic narrative (why — that's a different skill). diff --git a/optional-skills/software-development/rest-graphql-debug/SKILL.md b/optional-skills/software-development/rest-graphql-debug/SKILL.md index 64b96b3cdd..90496adc73 100644 --- a/optional-skills/software-development/rest-graphql-debug/SKILL.md +++ b/optional-skills/software-development/rest-graphql-debug/SKILL.md @@ -4,6 +4,7 @@ description: "Debug REST/GraphQL APIs: status codes, auth, schemas, repro." version: 1.2.0 author: eren-karakus0 license: MIT +platforms: [linux, macos, windows] metadata: hermes: tags: [api, rest, graphql, http, debugging, testing, curl, integration] diff --git a/optional-skills/yuanbao/SKILL.md b/optional-skills/yuanbao/SKILL.md index 6c261c68dd..aeeff05cd1 100644 --- a/optional-skills/yuanbao/SKILL.md +++ b/optional-skills/yuanbao/SKILL.md @@ -2,6 +2,8 @@ name: yuanbao description: "Yuanbao (元宝) groups: @mention users, query info/members." version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos, windows] metadata: hermes: diff --git a/skills/autonomous-ai-agents/computer-use/SKILL.md b/skills/autonomous-ai-agents/computer-use/SKILL.md index dd3b3b8da4..c98c1ef39f 100644 --- a/skills/autonomous-ai-agents/computer-use/SKILL.md +++ b/skills/autonomous-ai-agents/computer-use/SKILL.md @@ -1,12 +1,9 @@ --- name: computer-use -description: | - Drive the user's desktop in the background — clicking, typing, - scrolling, dragging — without stealing the cursor, keyboard focus, - or switching virtual desktops / Spaces. Cross-platform: macOS, - Windows, Linux. Works with any tool-capable model. Load this skill - whenever the `computer_use` tool is available. +description: "Drive the desktop in the background without stealing focus." version: 2.0.0 +author: Francesco Bonacci (f-trycua), Hermes Agent +license: MIT platforms: [macos, windows, linux] metadata: hermes: diff --git a/skills/creative/ascii-video/SKILL.md b/skills/creative/ascii-video/SKILL.md index b3eba0ac17..8534dfbfc0 100644 --- a/skills/creative/ascii-video/SKILL.md +++ b/skills/creative/ascii-video/SKILL.md @@ -1,7 +1,14 @@ --- name: ascii-video description: "ASCII video: convert video/audio to colored ASCII MP4/GIF." +version: 1.0.0 +author: SHL0MS, Hermes Agent +license: MIT platforms: [linux, macos, windows] +metadata: + hermes: + tags: [ASCII, Video, FFmpeg, Terminal-Art] + related_skills: [] --- # ASCII Video Production Pipeline diff --git a/skills/creative/manim-video/SKILL.md b/skills/creative/manim-video/SKILL.md index e82c7ccb2d..6059efa1a1 100644 --- a/skills/creative/manim-video/SKILL.md +++ b/skills/creative/manim-video/SKILL.md @@ -2,7 +2,13 @@ name: manim-video description: "Manim CE animations: 3Blue1Brown math/algo videos." version: 1.0.0 +author: SHL0MS, Hermes Agent +license: MIT platforms: [linux, macos, windows] +metadata: + hermes: + tags: [Manim, Animation, Math, Video] + related_skills: [] --- # Manim Video Production Pipeline diff --git a/skills/creative/p5js/SKILL.md b/skills/creative/p5js/SKILL.md index 819259c562..5c4083b9a7 100644 --- a/skills/creative/p5js/SKILL.md +++ b/skills/creative/p5js/SKILL.md @@ -2,6 +2,8 @@ name: p5js description: "p5.js sketches: gen art, shaders, interactive, 3D." version: 1.0.0 +author: SHL0MS, Hermes Agent +license: MIT platforms: [linux, macos, windows] metadata: hermes: diff --git a/skills/creative/songwriting-and-ai-music/SKILL.md b/skills/creative/songwriting-and-ai-music/SKILL.md index 250e2746fd..148e3d3e3b 100644 --- a/skills/creative/songwriting-and-ai-music/SKILL.md +++ b/skills/creative/songwriting-and-ai-music/SKILL.md @@ -1,6 +1,9 @@ --- name: songwriting-and-ai-music description: "Songwriting craft and Suno AI music prompts." +version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT tags: [songwriting, music, suno, parody, lyrics, creative] platforms: [linux, macos, windows] triggers: diff --git a/skills/media/youtube-content/SKILL.md b/skills/media/youtube-content/SKILL.md index 3661acad12..8e445f5f26 100644 --- a/skills/media/youtube-content/SKILL.md +++ b/skills/media/youtube-content/SKILL.md @@ -1,7 +1,14 @@ --- name: youtube-content description: "YouTube transcripts to summaries, threads, blogs." +version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos, windows] +metadata: + hermes: + tags: [YouTube, Video, Transcripts, Media] + related_skills: [] --- # YouTube Content Tool diff --git a/skills/note-taking/obsidian/SKILL.md b/skills/note-taking/obsidian/SKILL.md index e3a9872309..cc8f3cf737 100644 --- a/skills/note-taking/obsidian/SKILL.md +++ b/skills/note-taking/obsidian/SKILL.md @@ -1,7 +1,14 @@ --- name: obsidian description: Read, search, create, and edit notes in the Obsidian vault. +version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos, windows] +metadata: + hermes: + tags: [Obsidian, Notes, Markdown, Vault] + related_skills: [] --- # Obsidian Vault diff --git a/skills/productivity/google-workspace/SKILL.md b/skills/productivity/google-workspace/SKILL.md index 602dc7c5ee..d27d91b342 100644 --- a/skills/productivity/google-workspace/SKILL.md +++ b/skills/productivity/google-workspace/SKILL.md @@ -102,7 +102,7 @@ Tell the user: > 6. Download the JSON file and tell me the file path > > Important Hermes CLI note: if the file path starts with `/`, do NOT send only the bare path as its own message in the CLI, because it can be mistaken for a slash command. Send it in a sentence instead, like: -> `The JSON file path is: /home/user/Downloads/client_secret_....json` +> `The JSON file path is: ~/Downloads/client_secret_....json` Once they provide the path: diff --git a/skills/productivity/teams-meeting-pipeline/SKILL.md b/skills/productivity/teams-meeting-pipeline/SKILL.md index 775e3a5ceb..776913e802 100644 --- a/skills/productivity/teams-meeting-pipeline/SKILL.md +++ b/skills/productivity/teams-meeting-pipeline/SKILL.md @@ -4,6 +4,7 @@ description: Teams meeting summaries, job replay, Graph subscriptions. version: 1.1.0 author: Hermes Agent + Teknium license: MIT +platforms: [linux, macos, windows] prerequisites: env_vars: [MSGRAPH_TENANT_ID, MSGRAPH_CLIENT_ID, MSGRAPH_CLIENT_SECRET] commands: [hermes] diff --git a/skills/research/llm-wiki/SKILL.md b/skills/research/llm-wiki/SKILL.md index 7dc708c9a5..a7a03d422b 100644 --- a/skills/research/llm-wiki/SKILL.md +++ b/skills/research/llm-wiki/SKILL.md @@ -456,7 +456,7 @@ Wants=network-online.target [Service] ExecStart=/path/to/ob sync --continuous -WorkingDirectory=/home/user/wiki +WorkingDirectory=%h/wiki Restart=on-failure RestartSec=10 diff --git a/skills/software-development/dogfood/SKILL.md b/skills/software-development/dogfood/SKILL.md index 82d7dca201..a41419fe58 100644 --- a/skills/software-development/dogfood/SKILL.md +++ b/skills/software-development/dogfood/SKILL.md @@ -2,6 +2,8 @@ name: dogfood description: "Exploratory QA of web apps: find bugs, evidence, reports." version: 1.0.0 +author: Teknium (teknium1), Hermes Agent +license: MIT platforms: [linux, macos, windows] metadata: hermes: diff --git a/skills/software-development/node-inspect-debugger/SKILL.md b/skills/software-development/node-inspect-debugger/SKILL.md index 5f3f147102..71603beef1 100644 --- a/skills/software-development/node-inspect-debugger/SKILL.md +++ b/skills/software-development/node-inspect-debugger/SKILL.md @@ -183,7 +183,7 @@ The TUI is built Ink + tsx. Two common scenarios: `ui-tui/package.json` has `npm run dev` (tsx --watch). Add `--inspect-brk` by running tsx directly: ```bash -cd /home/bb/hermes-agent/ui-tui +cd /ui-tui npm run build # produce dist/ once so transpile isn't needed on first load node --inspect-brk dist/entry.js # In another terminal: @@ -227,7 +227,7 @@ Those are Python, not Node — use the `python-debugpy` skill for them. Only Nod ## Running Vitest Tests Under the Debugger ```bash -cd /home/bb/hermes-agent/ui-tui +cd /ui-tui # Run a single test file paused on entry node --inspect-brk ./node_modules/vitest/vitest.mjs run --no-file-parallelism src/app/foo.test.tsx ``` diff --git a/skills/software-development/python-debugpy/SKILL.md b/skills/software-development/python-debugpy/SKILL.md index 9907afdac1..c94dfdf526 100644 --- a/skills/software-development/python-debugpy/SKILL.md +++ b/skills/software-development/python-debugpy/SKILL.md @@ -149,7 +149,7 @@ For long-lived processes: Hermes gateway, tui_gateway, a daemon, a process that' ### Setup ```bash -source /home/bb/hermes-agent/.venv/bin/activate +source /.venv/bin/activate pip install debugpy ``` @@ -246,7 +246,7 @@ This is fine for one-off automation but painful as an interactive UX. "connect": { "host": "127.0.0.1", "port": 5678 }, "justMyCode": false, "pathMappings": [ - { "localRoot": "${workspaceFolder}", "remoteRoot": "/home/bb/hermes-agent" } + { "localRoot": "${workspaceFolder}", "remoteRoot": "" } ] } ``` diff --git a/website/docs/reference/optional-skills-catalog.md b/website/docs/reference/optional-skills-catalog.md index aebac2b39a..cc762fc0b3 100644 --- a/website/docs/reference/optional-skills-catalog.md +++ b/website/docs/reference/optional-skills-catalog.md @@ -49,7 +49,7 @@ hermes skills uninstall | Skill | Description | |-------|-------------| -| [**one-three-one-rule**](/docs/user-guide/skills/optional/communication/communication-one-three-one-rule) | Structured decision-making framework for technical proposals and trade-off analysis. When the user faces a choice between multiple approaches (architecture decisions, tool selection, refactoring strategies, migration paths), this skill p... | +| [**one-three-one-rule**](/docs/user-guide/skills/optional/communication/communication-one-three-one-rule) | 1-3-1 decision briefs: problem, three options, one pick. | ## creative @@ -80,6 +80,7 @@ hermes skills uninstall | Skill | Description | |-------|-------------| +| [**actual-setup**](/docs/user-guide/skills/optional/devops/devops-actual-setup) | Set up Actual Computer (actual.inc) inference in Hermes. | | [**inference-sh-cli**](/docs/user-guide/skills/optional/devops/devops-cli) | Run 150+ AI apps (image, video, LLM) via inference.sh CLI. | | [**docker-management**](/docs/user-guide/skills/optional/devops/devops-docker-management) | Manage Docker containers, images, volumes, and Compose. | | [**hermes-s6-container-supervision**](/docs/user-guide/skills/optional/devops/devops-hermes-s6-container-supervision) | Modify or debug s6 services in the Hermes Docker image. | @@ -123,8 +124,8 @@ hermes skills uninstall | Skill | Description | |-------|-------------| -| [**fitness-nutrition**](/docs/user-guide/skills/optional/health/health-fitness-nutrition) | Gym workout planner and nutrition tracker. Search 690+ exercises by muscle, equipment, or category via wger. Look up macros and calories for 380,000+ foods via USDA FoodData Central. Compute BMI, TDEE, one-rep max, macro splits, and body... | -| [**neuroskill-bci**](/docs/user-guide/skills/optional/health/health-neuroskill-bci) | Connect to a running NeuroSkill instance and incorporate the user's real-time cognitive and emotional state (focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV, sleep staging, and 40+ derived EXG scores) into responses.... | +| [**fitness-nutrition**](/docs/user-guide/skills/optional/health/health-fitness-nutrition) | Workout planning, macros, and body metrics via wger/USDA. | +| [**neuroskill-bci**](/docs/user-guide/skills/optional/health/health-neuroskill-bci) | Use live BCI cognitive and mood state from NeuroSkill. | ## mcp @@ -190,7 +191,7 @@ hermes skills uninstall |-------|-------------| | [**canvas**](/docs/user-guide/skills/optional/productivity/productivity-canvas) | Fetch Canvas LMS courses and assignments via API token. | | [**here.now**](/docs/user-guide/skills/optional/productivity/productivity-here-now) | Publish sites to {slug}.here.now and store files in Drives. | -| [**memento-flashcards**](/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards) | Spaced-repetition flashcard system. Create cards from facts or text, chat with flashcards using free-text answers graded by the agent, generate quizzes from YouTube transcripts, review due cards with adaptive scheduling, and export/impor... | +| [**memento-flashcards**](/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards) | Spaced-repetition flashcards: create, review, quiz, export. | | [**shop**](/docs/user-guide/skills/optional/productivity/productivity-shop) | Shop catalog search, checkout, order tracking, returns. | | [**shopify**](/docs/user-guide/skills/optional/productivity/productivity-shopify) | Query Shopify Admin/Storefront GraphQL APIs via curl. | | [**siyuan**](/docs/user-guide/skills/optional/productivity/productivity-siyuan) | Query and edit a SiYuan knowledge base via its API. | @@ -203,7 +204,7 @@ hermes skills uninstall | [**bioinformatics**](/docs/user-guide/skills/optional/research/research-bioinformatics) | Gateway to 400+ genomics and computational biology skills. | | [**darwinian-evolver**](/docs/user-guide/skills/optional/research/research-darwinian-evolver) | Evolve prompts/regex/SQL/code with Imbue's evolution loop. | | [**domain-intel**](/docs/user-guide/skills/optional/research/research-domain-intel) | Passive recon of subdomains, SSL certs, WHOIS, and DNS. | -| [**drug-discovery**](/docs/user-guide/skills/optional/research/research-drug-discovery) | Pharmaceutical research assistant for drug discovery workflows. Search bioactive compounds on ChEMBL, calculate drug-likeness (Lipinski Ro5, QED, TPSA, synthetic accessibility), look up drug-drug interactions via OpenFDA, interpret ADMET... | +| [**drug-discovery**](/docs/user-guide/skills/optional/research/research-drug-discovery) | Drug discovery: ChEMBL search, drug-likeness, interactions. | | [**duckduckgo-search**](/docs/user-guide/skills/optional/research/research-duckduckgo-search) | Free keyless web, news, and image search via ddgs. | | [**gitnexus-explorer**](/docs/user-guide/skills/optional/research/research-gitnexus-explorer) | Serve an interactive codebase knowledge graph web UI. | | [**osint-investigation**](/docs/user-guide/skills/optional/research/research-osint-investigation) | Follow the money via public records and sanctions data. | @@ -219,10 +220,10 @@ hermes skills uninstall |-------|-------------| | [**1password**](/docs/user-guide/skills/optional/security/security-1password) | Set up op CLI, sign in, and read or inject secrets. | | [**godmode**](/docs/user-guide/skills/optional/security/security-godmode) | Jailbreak LLMs: Parseltongue, GODMODE, ULTRAPLINIAN. | -| [**oss-forensics**](/docs/user-guide/skills/optional/security/security-oss-forensics) | Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories. Covers deleted commit recovery, force-push detection, IOC extraction, multi-source evidence collection, hypothesis formation/validation, and st... | +| [**oss-forensics**](/docs/user-guide/skills/optional/security/security-oss-forensics) | GitHub supply-chain forensics: recovery, IOCs, reporting. | | [**sherlock**](/docs/user-guide/skills/optional/security/security-sherlock) | Find accounts for a username across 400+ platforms. | | [**unbroker**](/docs/user-guide/skills/optional/security/security-unbroker) | Autonomously remove your info from data-broker sites. | -| [**web-pentest**](/docs/user-guide/skills/optional/security/security-web-pentest) | Authorized web application penetration testing — reconnaissance, vulnerability analysis, proof-based exploitation, and professional reporting. Adapts Shannon's "No Exploit, No Report" methodology with hard guardrails for scope, authoriza... | +| [**web-pentest**](/docs/user-guide/skills/optional/security/security-web-pentest) | Authorized web pentest: recon, proof-based exploits, report. | ## software-development diff --git a/website/docs/reference/skills-catalog.md b/website/docs/reference/skills-catalog.md index eabb33a7c1..fba5674e0a 100644 --- a/website/docs/reference/skills-catalog.md +++ b/website/docs/reference/skills-catalog.md @@ -27,7 +27,7 @@ If a skill is missing from this list but present in the repo, the catalog is reg |-------|-------------|------| | [`claude-code`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-claude-code) | Delegate coding to Claude Code CLI (features, PRs). | `autonomous-ai-agents/claude-code` | | [`codex`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-codex) | Delegate coding to OpenAI Codex CLI (features, PRs). | `autonomous-ai-agents/codex` | -| [`computer-use`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use) | Drive the user's desktop in the background — clicking, typing, scrolling, dragging — without stealing the cursor, keyboard focus, or switching virtual desktops / Spaces. Cross-platform: macOS, Windows, Linux. Works with any tool-capable... | `autonomous-ai-agents/computer-use` | +| [`computer-use`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use) | Drive the desktop in the background without stealing focus. | `autonomous-ai-agents/computer-use` | | [`hermes-agent`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent) | Use, configure, theme, extend, and orchestrate Hermes Agent. | `autonomous-ai-agents/hermes-agent` | | [`opencode`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-opencode) | Delegate coding to OpenCode CLI (features, PR review). | `autonomous-ai-agents/opencode` | diff --git a/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md b/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md index 44e28074fb..5996c313d1 100644 --- a/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md +++ b/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md @@ -1,18 +1,14 @@ --- -title: "Computer Use" +title: "Computer Use — Drive the desktop in the background without stealing focus" sidebar_label: "Computer Use" -description: "Drive the user's desktop in the background — clicking, typing, scrolling, dragging — without stealing the cursor, keyboard focus, or switching virtual deskto..." +description: "Drive the desktop in the background without stealing focus" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # Computer Use -Drive the user's desktop in the background — clicking, typing, -scrolling, dragging — without stealing the cursor, keyboard focus, -or switching virtual desktops / Spaces. Cross-platform: macOS, -Windows, Linux. Works with any tool-capable model. Load this skill -whenever the `computer_use` tool is available. +Drive the desktop in the background without stealing focus. ## Skill metadata @@ -21,6 +17,8 @@ whenever the `computer_use` tool is available. | Source | Bundled (installed by default) | | Path | `skills/autonomous-ai-agents/computer-use` | | Version | `2.0.0` | +| Author | Francesco Bonacci (f-trycua), Hermes Agent | +| License | MIT | | Platforms | macos, windows, linux | | Tags | `computer-use`, `desktop`, `automation`, `gui`, `cross-platform` | @@ -117,8 +115,9 @@ screenshot in the same tool call. All actions that target an element accept `modifiers=[…]` for held keys. The input actions (`click`, `double_click`, `right_click`, `middle_click`, -`drag`, `scroll`, `type`, `key`) also accept `delivery_mode` and -`bring_to_front` — see "The verify → escalate ladder" below. +`drag`, `scroll`, `type`, `key`) also accept `delivery_mode`. The optional +`bring_to_front=True` request invokes a separately approved standalone focus +tool before foreground input; it is never an input-action property. ## The verify → escalate ladder (background-first) @@ -140,11 +139,17 @@ Walk it in order: 1. **Element, background (default).** `click(element=N)`. If `effect:"confirmed"`, you're done. -2. **Pixel, background.** On `escalation.recommended == "px"` (or a `degraded` - capture with an empty element list), click by `coordinate=[x,y]` read off the - screenshot instead of `element`. -3. **Foreground.** On `escalation.recommended == "foreground"`, - `code:"background_unavailable"`, or a pixel click that still didn't land, +2. **Fresh verification.** `effect:"unverifiable"` means inspect a fresh + capture/state before any retry. Do this even when `escalation.recommended` + is present; it is advisory, not proof that successful input should repeat. +3. **Pixel, background.** After `effect:"suspected_noop"` or a structured + refusal recommends `"px"` (or a `degraded` capture has no elements), click + by `coordinate=[x,y]` instead of `element`. +4. **Typed page.** When `escalation.recommended == "page"` and the exact + browser-page contract below is available, use the namespaced typed route + before native foreground. This is not the legacy `page` workflow. +5. **Foreground.** After `effect:"suspected_noop"`, + `code:"background_unavailable"`, or a verified pixel no-op, re-issue the SAME action with `delivery_mode="foreground"`. This briefly raises the window and restores focus after; pair with `bring_to_front=True` for a short sequence to avoid per-call flashes. It needs its own approval @@ -160,11 +165,47 @@ computer_use(action="click", element=7, delivery_mode="foreground") ``` **Escalate to foreground as a REACTION to a returned signal, never as a -prediction** from the app being Electron/Chromium/GTK. Different controls in +prediction** from the app being Electron/Chromium/GTK. A confirmed effect is +done and must not be duplicated. Different controls in the same app behave differently. Do NOT silently retry the same rung, and do NOT conclude "cua-driver can't drive this app" — climb the ladder. If -`delivery_mode="foreground"` returns `code:"foreground_unsupported"`, the -driver is too old; tell the user to update cua-driver. +`delivery_mode="foreground"` returns `code:"foreground_unsupported"`, the live +action schema lacks that property; choose another verified rung without +inferring support from the executable's reported version. + +## Typed browser page rung + +For page content in a supported GUI browser, the same `computer_use` tool +exposes namespaced `cua_browser_*` actions. They do not collide with other +browser tools. The contract is capability-based: + +1. Discover the exact native browser `(pid, window_id)` with `list_windows` or + native capture, then call `cua_browser_state` with both values. +2. Continue only when it returns `status:"ok"`, `binding_quality:"exact"`, and + `mutation_allowed:true`. Select an opaque `tab_id` from that response. +3. Call `cua_browser_state` with the `tab_id` for a fresh `semantic_v2` + snapshot. Use only refs from that newest snapshot and only for their + declared actions. +4. Use the matching namespaced action (`cua_browser_click`, + `cua_browser_type`, `cua_browser_navigate`, or `cua_browser_pointer`). + Trusted input is the default. `input_route="dom_event"` is an explicit + trust downgrade; never choose it silently after a refusal. +5. Every mutation invalidates refs. Take a fresh state snapshot before another + typed action. Never chain actions from remembered refs. + +`cua_browser_prepare` is a separate approved setup action. Driver-owned +`isolated_new`/`isolated_named` profiles require explicit `allow_launch=true`. +An `existing_profile` is decided by cua-driver's immutable permission mode. +Normal Hermes sessions use `standard`, which requires a certified protected +host and fails closed when Hermes has none. Explicit Hermes YOLO (`--yolo`, +`/yolo`, or `approvals.mode: off`) launches a private embedded cua-driver in +`unrestricted` after that risk acceptance, so there are no runtime Cua +approval prompts. Never invent, store, log, or reuse a grant token. + +Use the native capture/AX/pixel/foreground ladder for browser chrome, browser +permission UI, OS prompts, native dialogs, extension surfaces, unsupported +engines, and any typed route that cannot prove exact binding or mutation +permission. `cua_browser_dialog` covers page JavaScript dialogs only. ### Key shortcuts vary per platform @@ -270,14 +311,14 @@ in your conversation context. | `cua-driver not installed` | Run `hermes computer-use install`, or `hermes tools` and enable Computer Use | | Captures consistently return empty / "no on-screen window" | On Linux: DISPLAY may not be set (X11) or you're on pure Wayland — ask the user to run `hermes computer-use doctor`. On Windows: you may be in Session 0 (SSH session) instead of the interactive desktop — see the cua-driver `WINDOWS.md` deep-dive | | Element index stale ("Element N not in cache") | SOM indices are only valid until the next `capture`. Re-capture before clicking. The wrapper carries opaque `element_token`s for stale-detection; you'll see an explicit error rather than a wrong click | -| Click had no effect | Read the structured verdict, don't just recapture. `effect:"unverifiable"` → re-capture and confirm yourself. `effect:"suspected_noop"` / `code:"background_unavailable"` / `escalation.recommended` → climb the ladder: try `coordinate=[x,y]` (px), then `delivery_mode="foreground"`. A modal (e.g. an Electron consent dialog) may be blocking input — foreground delivery is how you dismiss it. Don't conclude the app is undrivable | +| Click had no effect | Read the structured verdict. `effect:"unverifiable"` → fresh capture/state before retry, even with an escalation hint. `effect:"suspected_noop"` or a structured refusal → climb the recommended ladder: coordinate (px), typed page route when exact, then foreground. Browser chrome/native prompts remain native. Don't conclude the app is undrivable | | Type text disappears into a terminal emulator | cua-driver detects terminals (Ghostty, iTerm2, Terminal.app, Windows Terminal, mintty, etc.) and routes through key-event synthesis — should "just work" on a recent cua-driver. If it doesn't, ask the user to run `hermes computer-use doctor` | | `blocked pattern in type text` | You tried to `type` a shell command matching the dangerous-pattern block list (`curl ... \| bash`, `sudo rm -rf`, etc.). Break the command up or reconsider | | Anything else weird | **First action: ask the user to run `hermes computer-use doctor`.** It runs the cua-driver `health_report` MCP tool and prints a structured per-check matrix. Their output tells you (and them) exactly what's wrong | ## When NOT to use `computer_use` -- **Web automation you can do via `browser_*` tools** — those use a +- **Web automation you can do via separate headless `browser_*` tools** — those use a real headless Chromium and are more reliable than driving the user's GUI browser. Reach for `computer_use` specifically when the task needs the user's actual native apps (Finder/Explorer/Files, Mail/ diff --git a/website/docs/user-guide/skills/bundled/creative/creative-ascii-video.md b/website/docs/user-guide/skills/bundled/creative/creative-ascii-video.md index ad035fc50d..73eb134110 100644 --- a/website/docs/user-guide/skills/bundled/creative/creative-ascii-video.md +++ b/website/docs/user-guide/skills/bundled/creative/creative-ascii-video.md @@ -16,7 +16,11 @@ ASCII video: convert video/audio to colored ASCII MP4/GIF. |---|---| | Source | Bundled (installed by default) | | Path | `skills/creative/ascii-video` | +| Version | `1.0.0` | +| Author | SHL0MS, Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | +| Tags | `ASCII`, `Video`, `FFmpeg`, `Terminal-Art` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/bundled/creative/creative-manim-video.md b/website/docs/user-guide/skills/bundled/creative/creative-manim-video.md index a0317cd85c..f22a7005d8 100644 --- a/website/docs/user-guide/skills/bundled/creative/creative-manim-video.md +++ b/website/docs/user-guide/skills/bundled/creative/creative-manim-video.md @@ -17,7 +17,10 @@ Manim CE animations: 3Blue1Brown math/algo videos. | Source | Bundled (installed by default) | | Path | `skills/creative/manim-video` | | Version | `1.0.0` | +| Author | SHL0MS, Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | +| Tags | `Manim`, `Animation`, `Math`, `Video` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/bundled/creative/creative-p5js.md b/website/docs/user-guide/skills/bundled/creative/creative-p5js.md index a59b6bf06c..46ecfa9299 100644 --- a/website/docs/user-guide/skills/bundled/creative/creative-p5js.md +++ b/website/docs/user-guide/skills/bundled/creative/creative-p5js.md @@ -17,6 +17,8 @@ p5.js sketches: gen art, shaders, interactive, 3D. | Source | Bundled (installed by default) | | Path | `skills/creative/p5js` | | Version | `1.0.0` | +| Author | SHL0MS, Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | | Tags | `creative-coding`, `generative-art`, `p5js`, `canvas`, `interactive`, `visualization`, `webgl`, `shaders`, `animation` | | Related skills | [`ascii-video`](/docs/user-guide/skills/bundled/creative/creative-ascii-video), [`manim-video`](/docs/user-guide/skills/bundled/creative/creative-manim-video), [`excalidraw`](/docs/user-guide/skills/bundled/creative/creative-excalidraw) | diff --git a/website/docs/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music.md b/website/docs/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music.md index 6b0cdbb70a..db3781f7e6 100644 --- a/website/docs/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music.md +++ b/website/docs/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music.md @@ -16,6 +16,9 @@ Songwriting craft and Suno AI music prompts. |---|---| | Source | Bundled (installed by default) | | Path | `skills/creative/songwriting-and-ai-music` | +| Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/bundled/media/media-youtube-content.md b/website/docs/user-guide/skills/bundled/media/media-youtube-content.md index 2971a56f95..47cc4acc46 100644 --- a/website/docs/user-guide/skills/bundled/media/media-youtube-content.md +++ b/website/docs/user-guide/skills/bundled/media/media-youtube-content.md @@ -16,7 +16,11 @@ YouTube transcripts to summaries, threads, blogs. |---|---| | Source | Bundled (installed by default) | | Path | `skills/media/youtube-content` | +| Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | +| Tags | `YouTube`, `Video`, `Transcripts`, `Media` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/bundled/note-taking/note-taking-obsidian.md b/website/docs/user-guide/skills/bundled/note-taking/note-taking-obsidian.md index 49f317144d..22e5178a68 100644 --- a/website/docs/user-guide/skills/bundled/note-taking/note-taking-obsidian.md +++ b/website/docs/user-guide/skills/bundled/note-taking/note-taking-obsidian.md @@ -16,7 +16,11 @@ Read, search, create, and edit notes in the Obsidian vault. |---|---| | Source | Bundled (installed by default) | | Path | `skills/note-taking/obsidian` | +| Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | +| Tags | `Obsidian`, `Notes`, `Markdown`, `Vault` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-google-workspace.md b/website/docs/user-guide/skills/bundled/productivity/productivity-google-workspace.md index f5939292e8..23c1245764 100644 --- a/website/docs/user-guide/skills/bundled/productivity/productivity-google-workspace.md +++ b/website/docs/user-guide/skills/bundled/productivity/productivity-google-workspace.md @@ -114,7 +114,7 @@ Tell the user: > 6. Download the JSON file and tell me the file path > > Important Hermes CLI note: if the file path starts with `/`, do NOT send only the bare path as its own message in the CLI, because it can be mistaken for a slash command. Send it in a sentence instead, like: -> `The JSON file path is: /home/user/Downloads/client_secret_....json` +> `The JSON file path is: ~/Downloads/client_secret_....json` Once they provide the path: diff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline.md b/website/docs/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline.md index 9ff14e4b53..adac36e9c2 100644 --- a/website/docs/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline.md +++ b/website/docs/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline.md @@ -19,6 +19,7 @@ Teams meeting summaries, job replay, Graph subscriptions. | Version | `1.1.0` | | Author | Hermes Agent + Teknium | | License | MIT | +| Platforms | linux, macos, windows | | Tags | `Teams`, `Microsoft Graph`, `Meetings`, `Productivity`, `Operations` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/bundled/research/research-llm-wiki.md b/website/docs/user-guide/skills/bundled/research/research-llm-wiki.md index a6097a1a07..566c7378b9 100644 --- a/website/docs/user-guide/skills/bundled/research/research-llm-wiki.md +++ b/website/docs/user-guide/skills/bundled/research/research-llm-wiki.md @@ -475,7 +475,7 @@ Wants=network-online.target [Service] ExecStart=/path/to/ob sync --continuous -WorkingDirectory=/home/user/wiki +WorkingDirectory=%h/wiki Restart=on-failure RestartSec=10 diff --git a/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md b/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md index 5849bff96b..953add5b00 100644 --- a/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md +++ b/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md @@ -17,6 +17,8 @@ Exploratory QA of web apps: find bugs, evidence, reports. | Source | Bundled (installed by default) | | Path | `skills/software-development/dogfood` | | Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | | Tags | `qa`, `testing`, `browser`, `web`, `dogfood` | diff --git a/website/docs/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger.md b/website/docs/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger.md index 00b1f8bc7a..57f26162d8 100644 --- a/website/docs/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger.md +++ b/website/docs/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger.md @@ -201,7 +201,7 @@ The TUI is built Ink + tsx. Two common scenarios: `ui-tui/package.json` has `npm run dev` (tsx --watch). Add `--inspect-brk` by running tsx directly: ```bash -cd /home/bb/hermes-agent/ui-tui +cd /ui-tui npm run build # produce dist/ once so transpile isn't needed on first load node --inspect-brk dist/entry.js # In another terminal: @@ -245,7 +245,7 @@ Those are Python, not Node — use the `python-debugpy` skill for them. Only Nod ## Running Vitest Tests Under the Debugger ```bash -cd /home/bb/hermes-agent/ui-tui +cd /ui-tui # Run a single test file paused on entry node --inspect-brk ./node_modules/vitest/vitest.mjs run --no-file-parallelism src/app/foo.test.tsx ``` diff --git a/website/docs/user-guide/skills/bundled/software-development/software-development-python-debugpy.md b/website/docs/user-guide/skills/bundled/software-development/software-development-python-debugpy.md index dcb66a389b..4f7c4c37e3 100644 --- a/website/docs/user-guide/skills/bundled/software-development/software-development-python-debugpy.md +++ b/website/docs/user-guide/skills/bundled/software-development/software-development-python-debugpy.md @@ -125,11 +125,9 @@ scripts/run_tests.sh tests/path/to/test_file.py::test_name --trace scripts/run_tests.sh tests/path/to/test_file.py --showlocals --tb=long ``` -Note: `scripts/run_tests.sh` uses xdist (`-n 4`) by default, and pdb does NOT work under xdist. Add `-p no:xdist` or run a single test with `-n 0`: +Note: `scripts/run_tests.sh` runs each test file in a captured subprocess via `run_tests_parallel.py` (no xdist), so interactive pdb does NOT work under the wrapper. Run pytest directly for `--pdb`: ```bash -scripts/run_tests.sh tests/foo_test.py::test_bar --pdb -p no:xdist -# or source .venv/bin/activate python -m pytest tests/foo_test.py::test_bar --pdb ``` @@ -169,7 +167,7 @@ For long-lived processes: Hermes gateway, tui_gateway, a daemon, a process that' ### Setup ```bash -source /home/bb/hermes-agent/.venv/bin/activate +source /.venv/bin/activate pip install debugpy ``` @@ -266,7 +264,7 @@ This is fine for one-off automation but painful as an interactive UX. "connect": { "host": "127.0.0.1", "port": 5678 }, "justMyCode": false, "pathMappings": [ - { "localRoot": "${workspaceFolder}", "remoteRoot": "/home/bb/hermes-agent" } + { "localRoot": "${workspaceFolder}", "remoteRoot": "" } ] } ``` @@ -294,7 +292,7 @@ nc 127.0.0.1 4444 ## Debugging Hermes-specific Processes ### Tests -See Recipe 3. Always add `-p no:xdist` or run single tests without xdist. +See Recipe 3. The wrapper captures subprocess output, so run pytest directly for interactive pdb. ### `run_agent.py` / CLI — one-shot Easiest: add `breakpoint()` near the suspect line, then run `hermes` normally. Control returns to your terminal at the pause point. @@ -326,7 +324,7 @@ Long-lived. Use `remote-pdb` at a handler, or `debugpy` with `--wait-for-client` ## Common Pitfalls -1. **pdb under pytest-xdist silently does nothing.** You won't see the prompt, the test just hangs. Always use `-p no:xdist` or `-n 0`. +1. **pdb under a parallel/output-capturing runner silently does nothing.** You won't see the prompt, the test just hangs (true of pytest-xdist and of `scripts/run_tests.sh`'s captured per-file subprocesses). Run pytest directly on a single file for interactive debugging. 2. **`breakpoint()` in CI / non-TTY contexts hangs the process.** Safe locally; never commit it. Add a pre-commit grep as a safety net. @@ -351,7 +349,7 @@ Long-lived. Use `remote-pdb` at a handler, or `debugpy` with `--wait-for-client` - [ ] After `pip install debugpy`, confirm: `python -c "import debugpy; print(debugpy.__version__)"` - [ ] For remote debug, confirm the port is actually listening: `ss -tlnp | grep 5678` -- [ ] First breakpoint actually hits (if it doesn't, you likely have `PYTHONBREAKPOINT=0`, you're under xdist, or execution finished before attach) +- [ ] First breakpoint actually hits (if it doesn't, you likely have `PYTHONBREAKPOINT=0`, you're under a parallel/capturing runner, or execution finished before attach) - [ ] `where` / `w` shows the expected call stack - [ ] Post-debug cleanup: no stray `breakpoint()` / `set_trace()` in committed code ```bash @@ -372,10 +370,10 @@ breakpoint() **"This test passes in isolation but fails in the suite."** ```bash -scripts/run_tests.sh tests/the_test.py --pdb -p no:xdist -# But if it only fails WITH other tests: +scripts/run_tests.sh tests/the_test.py # confirm it fails under the isolated runner first +# For interactive debugging, or if it only fails WITH other tests: source .venv/bin/activate -python -m pytest tests/ -x --pdb -p no:xdist +python -m pytest tests/ -x --pdb # Now it pdb-traps at the exact failing test after state accumulated. ``` diff --git a/website/docs/user-guide/skills/optional/communication/communication-one-three-one-rule.md b/website/docs/user-guide/skills/optional/communication/communication-one-three-one-rule.md index b99eb914d3..c0471b16ee 100644 --- a/website/docs/user-guide/skills/optional/communication/communication-one-three-one-rule.md +++ b/website/docs/user-guide/skills/optional/communication/communication-one-three-one-rule.md @@ -1,14 +1,14 @@ --- -title: "One Three One Rule — Structured decision-making framework for technical proposals and trade-off analysis" +title: "One Three One Rule — 1-3-1 decision briefs: problem, three options, one pick" sidebar_label: "One Three One Rule" -description: "Structured decision-making framework for technical proposals and trade-off analysis" +description: "1-3-1 decision briefs: problem, three options, one pick" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # One Three One Rule -Structured decision-making framework for technical proposals and trade-off analysis. When the user faces a choice between multiple approaches (architecture decisions, tool selection, refactoring strategies, migration paths), this skill produces a 1-3-1 format: one clear problem statement, three distinct options with pros/cons, and one concrete recommendation with definition of done and implementation plan. Use when the user asks for a "1-3-1", says "give me options", or needs help choosing between competing approaches. +1-3-1 decision briefs: problem, three options, one pick. ## Skill metadata diff --git a/website/docs/user-guide/skills/optional/creative/creative-audiocraft-audio-generation.md b/website/docs/user-guide/skills/optional/creative/creative-audiocraft-audio-generation.md index cde300fc26..418ab5e652 100644 --- a/website/docs/user-guide/skills/optional/creative/creative-audiocraft-audio-generation.md +++ b/website/docs/user-guide/skills/optional/creative/creative-audiocraft-audio-generation.md @@ -32,7 +32,7 @@ The following is the complete skill definition that Hermes loads when this skill # AudioCraft: Audio Generation -Comprehensive guide to using Meta's AudioCraft for text-to-music and text-to-audio generation with MusicGen, AudioGen, and EnCodec. +Guide to using Meta's AudioCraft for text-to-music and text-to-audio generation with MusicGen, AudioGen, and EnCodec. ## When to use AudioCraft diff --git a/website/docs/user-guide/skills/optional/creative/creative-blender-mcp.md b/website/docs/user-guide/skills/optional/creative/creative-blender-mcp.md index f69cca5afd..d6206c2f64 100644 --- a/website/docs/user-guide/skills/optional/creative/creative-blender-mcp.md +++ b/website/docs/user-guide/skills/optional/creative/creative-blender-mcp.md @@ -18,6 +18,7 @@ Drive Blender via the catalog blender MCP, with bpy recipes. | Path | `optional-skills/creative/blender-mcp` | | Version | `2.1.0` | | Author | alireza78a + kshitijk4poor + Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/optional/creative/creative-heartmula.md b/website/docs/user-guide/skills/optional/creative/creative-heartmula.md index 16dcf43c22..052970f3bb 100644 --- a/website/docs/user-guide/skills/optional/creative/creative-heartmula.md +++ b/website/docs/user-guide/skills/optional/creative/creative-heartmula.md @@ -17,6 +17,8 @@ HeartMuLa: Suno-like song generation from lyrics + tags. | Source | Optional — install with `hermes skills install official/creative/heartmula` | | Path | `optional-skills/creative/heartmula` | | Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | | Tags | `music`, `audio`, `generation`, `ai`, `heartmula`, `heartcodec`, `lyrics`, `songs` | | Related skills | [`audiocraft-audio-generation`](/docs/user-guide/skills/optional/creative/creative-audiocraft-audio-generation), [`songwriting-and-ai-music`](/docs/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music) | diff --git a/website/docs/user-guide/skills/optional/devops/devops-actual-setup.md b/website/docs/user-guide/skills/optional/devops/devops-actual-setup.md new file mode 100644 index 0000000000..d7fa4bd756 --- /dev/null +++ b/website/docs/user-guide/skills/optional/devops/devops-actual-setup.md @@ -0,0 +1,164 @@ +--- +title: "Actual Setup — Set up Actual Computer (actual.inc) inference in Hermes" +sidebar_label: "Actual Setup" +description: "Set up Actual Computer (actual.inc) inference in Hermes" +--- + +{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} + +# Actual Setup + +Set up Actual Computer (actual.inc) inference in Hermes. + +## Skill metadata + +| | | +|---|---| +| Source | Optional — install with `hermes skills install official/devops/actual-setup` | +| Path | `optional-skills/devops/actual-setup` | +| Version | `2.0.0` | +| Author | shl0ms + Hermes Agent | +| License | MIT | +| Platforms | linux, macos, windows | +| Tags | `actual`, `actual-inc`, `provider`, `local-inference`, `relay`, `gguf`, `setup` | + +## Reference: full SKILL.md + +:::info +The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. +::: + +# Actual Computer Setup Skill + +Sets up [actual.inc](https://actual.inc) (Actual Computer) as a Hermes inference +provider. Actual turns the user's own hardware into a private inference cluster +and exposes an OpenAI-compatible API two ways: a hosted end-to-end-encrypted +relay at `https://api.actual.inc` (authenticated with an `ac_` key), and a local +on-device daemon at `http://127.0.0.1:8080` (no auth on loopback). This skill +does not install the Actual daemon for the user — device authorization requires +a human in a browser. + +## When to Use + +- User wants to add actual.inc as an inference provider (cloud relay or local). +- User has an `ac_` key and wants Hermes routed through their Actual cluster. +- User wants fully-local, on-device inference via the Actual daemon. +- Troubleshooting: Actual requests failing with cryptic 400s or empty streams. + +## Prerequisites + +- Hermes has **first-class `actual` provider support** (provider id `actual`, + aliases `actual-computer`, `actualcomputer`, `aci`). Do NOT configure Actual + as a `custom_providers` / `providers.actual.*` entry on current Hermes — the + built-in provider owns the name and handles base-url normalization, the + Responses transport, and local no-auth automatically. +- Relay mode: an Actual account and an `ac_` inference key from + https://actual.inc/user/keys. +- Local mode: the user has installed the daemon + (`curl -fsSL "https://actual.inc/install" | bash`) and completed device + authorization by running `actual` once and opening the printed + `https://actual.inc/device?code=...` URL in a browser. Relay that URL to the + user and WAIT — never invent an email or authorize on their behalf. Codes + expire in 5 minutes; re-run `actual` for a fresh one. + +## How to Run + +### Relay / API mode + +1. Put the key in `.env` (secrets only — never config.yaml): + append `ACTUAL_API_KEY=ac_...` to `~/.hermes/.env`. +2. Verify the key and discover models with `terminal`: + ```bash + curl -s https://api.actual.inc/v1/models -H "Authorization: Bearer $ACTUAL_API_KEY" + ``` +3. Select provider + model: + ```bash + hermes config set model.provider actual + hermes config set model.default "MODEL_ID_FROM_DISCOVERY" + ``` +4. Verify end-to-end: + ```bash + hermes chat -Q -q "Reply with exactly: ACTUAL_OK" --provider actual -m MODEL_ID + ``` + +### Local mode + +1. Human has installed + authorized the daemon (see Prerequisites). +2. Download and load a model (scriptable once authorized): + ```bash + actual models search "qwen2.5 0.5b instruct gguf" --limit 8 --no-prompt + # Downloads REQUIRE an explicit quantization (409 ambiguous_model_download otherwise): + actual models download "Qwen/Qwen2.5-0.5B-Instruct-GGUF/Q4_K_M" + actual models list # note the INSTALLED name (differs from download id) + actual models load "qwen2.5-0.5b-instruct-q4_k_m" # load by installed name + ``` +3. Point Hermes at the daemon. `ACTUAL_BASE_URL` with a loopback host flips the + built-in provider into local no-auth mode automatically — no key needed: + append `ACTUAL_BASE_URL=http://127.0.0.1:8080` to `~/.hermes/.env`, then: + ```bash + hermes config set model.provider actual + hermes config set model.default "INSTALLED_MODEL_NAME" + ``` +4. Verify (reduced toolset — see context-window pitfall below): + ```bash + hermes chat -Q -q "Reply with exactly: LOCAL_OK" --provider actual -m INSTALLED_NAME -t file,web + ``` + +## Quick Reference + +| Thing | Value | +|---|---| +| Hosted relay | `https://api.actual.inc/v1` (normalized from bare host automatically) | +| Local daemon | `http://127.0.0.1:8080/v1` (no auth on loopback) | +| Key env var | `ACTUAL_API_KEY` (`ac_...`) | +| Base URL env var | `ACTUAL_BASE_URL` (loopback host ⇒ local no-auth mode) | +| Provider id / aliases | `actual` / `actual-computer`, `actualcomputer`, `aci` | +| Transport | Responses API (`codex_responses`) — built-in, do not override | +| Cluster pinning | `X-Cluster-ID` header via `providers.actual.extra_headers` in config.yaml | +| Model size guide | 0.5B Q4_K_M ~470MB (toy), 7-8B Q4_K_M ~4.5GB (daily driver), 32B ~20GB | + +## Pitfalls + +1. **reasoning_effort trap (handled by Hermes since the first-class provider).** + Actual's SGLang/vLLM backends accept only `none/low/medium/high/max`; + `xhigh`/`ultra` used to fail with a cryptic + `Expecting value: line 1 column 1 (char 0)` (a wrapped HTTP 400). The + built-in provider clamps `xhigh→high` and `ultra→max` on the wire. If a + request still 400s this way on an old Hermes, set a per-model cap: + `agent.reasoning_overrides.: high` in config.yaml. +2. **Context-window overflow on small local models.** Hermes' default toolset + is ~26k tokens of schemas plus a ~9k-token system prompt. A model loaded + with a 32k context overflows before the first turn, and llama.cpp-family + servers emit a bare `data: [DONE]` — Hermes reports + `Provider returned an empty stream with no finish_reason`. This is NOT an + SSE bug. Fixes: restrict tools (`-t file,web`), load the model with a + larger `n_ctx`, or pick a >=64k-context model for the full toolset. + Upstream tracking: #51448 (do not file new issues; add evidence there). + Related but distinct: #65631 (HTTP-200 SSE carrying a 400), #56516 + (reasoning-only streams). +3. **Download ids vs installed names.** `actual models download` takes + `repo/QUANT` and 409s without an explicit quantization; + `actual models load` takes the INSTALLED name from `actual models list`. +4. **Reasoning models returning empty content.** GLM/Qwen reasoning variants + emit thinking in a separate `reasoning` field and can burn a small + `max_tokens` entirely on reasoning. Give generous max_tokens before + assuming failure. +5. **Do not create a custom provider named `actual`.** Older setup guides + (pre first-class support) wrote `providers.actual.*` config blocks. On + current Hermes the built-in provider wins the name; stale custom blocks + are ignored or conflict. Remove them and use the env vars + model.provider + flow above. + +## Verification + +```bash +# Relay: +hermes chat -Q -q "Reply with exactly: ACTUAL_OK" --provider actual -m MODEL +# Local (small model — reduced toolset): +hermes chat -Q -q "Reply with exactly: LOCAL_OK" --provider actual -m MODEL -t file,web +# Provider status (local no-auth shows key_source=local-offline): +hermes status +``` + +For other OpenAI-compatible clients (e.g. OpenCode), see +`references/opencode.md`. diff --git a/website/docs/user-guide/skills/optional/email/email-agentmail.md b/website/docs/user-guide/skills/optional/email/email-agentmail.md index 0e500da190..e134da4667 100644 --- a/website/docs/user-guide/skills/optional/email/email-agentmail.md +++ b/website/docs/user-guide/skills/optional/email/email-agentmail.md @@ -17,6 +17,8 @@ Give the agent its own inbox: send and receive email. | Source | Optional — install with `hermes skills install official/email/agentmail` | | Path | `optional-skills/email/agentmail` | | Version | `1.0.0` | +| Author | teyrebaz33, Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | | Tags | `email`, `communication`, `agentmail`, `mcp` | diff --git a/website/docs/user-guide/skills/optional/finance/finance-polymarket.md b/website/docs/user-guide/skills/optional/finance/finance-polymarket.md index df70d5c7aa..78f370685a 100644 --- a/website/docs/user-guide/skills/optional/finance/finance-polymarket.md +++ b/website/docs/user-guide/skills/optional/finance/finance-polymarket.md @@ -18,6 +18,7 @@ Query Polymarket: markets, prices, orderbooks, history. | Path | `optional-skills/finance/polymarket` | | Version | `1.0.0` | | Author | Hermes Agent + Teknium | +| License | MIT | | Platforms | linux, macos, windows | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/optional/gaming/gaming-minecraft-modpack-server.md b/website/docs/user-guide/skills/optional/gaming/gaming-minecraft-modpack-server.md index a4d588f210..4b8f0ec356 100644 --- a/website/docs/user-guide/skills/optional/gaming/gaming-minecraft-modpack-server.md +++ b/website/docs/user-guide/skills/optional/gaming/gaming-minecraft-modpack-server.md @@ -16,6 +16,9 @@ Host modded Minecraft servers (CurseForge, Modrinth). |---|---| | Source | Optional — install with `hermes skills install official/gaming/minecraft-modpack-server` | | Path | `optional-skills/gaming/minecraft-modpack-server` | +| Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/optional/gaming/gaming-pokemon-player.md b/website/docs/user-guide/skills/optional/gaming/gaming-pokemon-player.md index fe523b645b..3a98d97a75 100644 --- a/website/docs/user-guide/skills/optional/gaming/gaming-pokemon-player.md +++ b/website/docs/user-guide/skills/optional/gaming/gaming-pokemon-player.md @@ -16,6 +16,9 @@ Play Pokemon via headless emulator + RAM reads. |---|---| | Source | Optional — install with `hermes skills install official/gaming/pokemon-player` | | Path | `optional-skills/gaming/pokemon-player` | +| Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | ## Reference: full SKILL.md @@ -42,11 +45,11 @@ set up a Python 3.10+ virtual environment. Use uv (preferred for speed) to create the venv and install the package in editable mode with the pyboy extra. If uv is not available, fall back to python3 -m venv + pip. -On this machine it is already set up at /home/teknium/pokemon-agent -with a venv ready — just cd there and source .venv/bin/activate. +If a checkout already exists (e.g. ~/pokemon-agent with a venv ready), +just cd there and source .venv/bin/activate instead of recloning. -You also need a ROM file. Ask the user for theirs. On this machine -one exists at roms/pokemon_red.gb inside that directory. +You also need a ROM file. Ask the user for theirs (a previous setup may +already have one at roms/pokemon_red.gb inside the checkout). NEVER download or provide ROM files — always ask the user. ### 2. Start the game server @@ -59,7 +62,8 @@ Wait 4 seconds for startup, then verify with GET /health. ### 3. Set up live dashboard for user to watch Use an SSH reverse tunnel via localhost.run so the user can view the dashboard in their browser. Connect with ssh, forwarding local -port 9876 to remote port 80 on nokey@localhost.run. Redirect output +port 9876 to remote port 80 on the keyless localhost.run endpoint +(ssh -R 80:localhost:9876 ssh://nokey@localhost.run). Redirect output to a log file, wait 10 seconds, then grep the log for the .lhr.life URL. Give the user the URL with /dashboard/ appended. The tunnel URL changes each time — give the user the new one if restarted. diff --git a/website/docs/user-guide/skills/optional/health/health-fitness-nutrition.md b/website/docs/user-guide/skills/optional/health/health-fitness-nutrition.md index bb1d85ed46..feb2a45049 100644 --- a/website/docs/user-guide/skills/optional/health/health-fitness-nutrition.md +++ b/website/docs/user-guide/skills/optional/health/health-fitness-nutrition.md @@ -1,14 +1,14 @@ --- -title: "Fitness Nutrition — Gym workout planner and nutrition tracker" +title: "Fitness Nutrition — Workout planning, macros, and body metrics via wger/USDA" sidebar_label: "Fitness Nutrition" -description: "Gym workout planner and nutrition tracker" +description: "Workout planning, macros, and body metrics via wger/USDA" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # Fitness Nutrition -Gym workout planner and nutrition tracker. Search 690+ exercises by muscle, equipment, or category via wger. Look up macros and calories for 380,000+ foods via USDA FoodData Central. Compute BMI, TDEE, one-rep max, macro splits, and body fat — pure Python, no pip installs. Built for anyone chasing gains, cutting weight, or just trying to eat better. +Workout planning, macros, and body metrics via wger/USDA. ## Skill metadata @@ -17,6 +17,7 @@ Gym workout planner and nutrition tracker. Search 690+ exercises by muscle, equi | Source | Optional — install with `hermes skills install official/health/fitness-nutrition` | | Path | `optional-skills/health/fitness-nutrition` | | Version | `1.0.0` | +| Author | Hailey Marshall (haileymarshall), Hermes Agent | | License | MIT | | Platforms | linux, macos, windows | | Tags | `health`, `fitness`, `nutrition`, `gym`, `workout`, `diet`, `exercise` | diff --git a/website/docs/user-guide/skills/optional/health/health-neuroskill-bci.md b/website/docs/user-guide/skills/optional/health/health-neuroskill-bci.md index 67d8f0e634..d011ca4455 100644 --- a/website/docs/user-guide/skills/optional/health/health-neuroskill-bci.md +++ b/website/docs/user-guide/skills/optional/health/health-neuroskill-bci.md @@ -1,14 +1,14 @@ --- -title: "Neuroskill Bci" +title: "Neuroskill Bci — Use live BCI cognitive and mood state from NeuroSkill" sidebar_label: "Neuroskill Bci" -description: "Connect to a running NeuroSkill instance and incorporate the user's real-time cognitive and emotional state (focus, relaxation, mood, cognitive load, drowsin..." +description: "Use live BCI cognitive and mood state from NeuroSkill" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # Neuroskill Bci -Connect to a running NeuroSkill instance and incorporate the user's real-time cognitive and emotional state (focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV, sleep staging, and 40+ derived EXG scores) into responses. Requires a BCI wearable (Muse 2/S or OpenBCI) and the NeuroSkill desktop app running locally. +Use live BCI cognitive and mood state from NeuroSkill. ## Skill metadata diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-lambda-labs.md b/website/docs/user-guide/skills/optional/mlops/mlops-lambda-labs.md index 500b8ae25d..ac41f5bb65 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-lambda-labs.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-lambda-labs.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # Lambda Labs GPU Cloud -Comprehensive guide to running ML workloads on Lambda Labs GPU cloud with on-demand instances and 1-Click Clusters. +Guide to running ML workloads on Lambda Labs GPU cloud with on-demand instances and 1-Click Clusters. ## When to use Lambda Labs @@ -304,7 +304,7 @@ Filesystems must be attached at instance launch time: └── outputs/ # Local SSD (faster, ephemeral) -/home/ubuntu/ +~/ (instance home) └── working/ # Temporary files ``` diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-modal.md b/website/docs/user-guide/skills/optional/mlops/mlops-modal.md index 0df1158851..b71fcaf31b 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-modal.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-modal.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # Modal Serverless GPU -Comprehensive guide to running ML workloads on Modal's serverless GPU cloud platform. +Guide to running ML workloads on Modal's serverless GPU cloud platform. ## When to use Modal diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-models-segment-anything-model.md b/website/docs/user-guide/skills/optional/mlops/mlops-models-segment-anything-model.md index 474b989f5f..f18118c370 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-models-segment-anything-model.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-models-segment-anything-model.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # Segment Anything Model (SAM) -Comprehensive guide to using Meta AI's Segment Anything Model for zero-shot image segmentation. +Guide to using Meta AI's Segment Anything Model for zero-shot image segmentation. ## When to use SAM diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-pytorch-fsdp.md b/website/docs/user-guide/skills/optional/mlops/mlops-pytorch-fsdp.md index 174d7497d4..4a245ffef0 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-pytorch-fsdp.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-pytorch-fsdp.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # Pytorch-Fsdp Skill -Comprehensive assistance with pytorch-fsdp development, generated from official documentation. +Assistance with pytorch-fsdp development, generated from official documentation. ## When to Use This Skill diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-stable-diffusion.md b/website/docs/user-guide/skills/optional/mlops/mlops-stable-diffusion.md index 8b00f8ba97..1b7f946b89 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-stable-diffusion.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-stable-diffusion.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # Stable Diffusion Image Generation -Comprehensive guide to generating images with Stable Diffusion using the HuggingFace Diffusers library. +Guide to generating images with Stable Diffusion using the HuggingFace Diffusers library. ## When to use Stable Diffusion diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-tensorrt-llm.md b/website/docs/user-guide/skills/optional/mlops/mlops-tensorrt-llm.md index 326d22e8cc..9ef46ce0fb 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-tensorrt-llm.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-tensorrt-llm.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # TensorRT-LLM -NVIDIA's open-source library for optimizing LLM inference with state-of-the-art performance on NVIDIA GPUs. +NVIDIA's open-source library for optimizing LLM inference with high performance on NVIDIA GPUs. ## When to use TensorRT-LLM diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-training-axolotl.md b/website/docs/user-guide/skills/optional/mlops/mlops-training-axolotl.md index 7f0b9b8071..a23fb70816 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-training-axolotl.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-training-axolotl.md @@ -35,7 +35,7 @@ The following is the complete skill definition that Hermes loads when this skill 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. +Assistance with axolotl development, generated from official documentation. ## When to Use This Skill diff --git a/website/docs/user-guide/skills/optional/mlops/mlops-training-unsloth.md b/website/docs/user-guide/skills/optional/mlops/mlops-training-unsloth.md index cf4566a181..28b7022797 100644 --- a/website/docs/user-guide/skills/optional/mlops/mlops-training-unsloth.md +++ b/website/docs/user-guide/skills/optional/mlops/mlops-training-unsloth.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # Unsloth Skill -Comprehensive assistance with unsloth development, generated from official documentation. +Assistance with unsloth development, generated from official documentation. ## When to Use This Skill @@ -50,7 +50,7 @@ This skill should be triggered when: ## Reference Files -This skill includes comprehensive documentation in `references/`: +This skill includes full documentation in `references/`: - **llms-txt.md** - Llms-Txt documentation diff --git a/website/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards.md b/website/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards.md index ade1a3d683..71caeb2607 100644 --- a/website/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards.md +++ b/website/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards.md @@ -1,14 +1,14 @@ --- -title: "Memento Flashcards — Spaced-repetition flashcard system" +title: "Memento Flashcards — Spaced-repetition flashcards: create, review, quiz, export" sidebar_label: "Memento Flashcards" -description: "Spaced-repetition flashcard system" +description: "Spaced-repetition flashcards: create, review, quiz, export" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # Memento Flashcards -Spaced-repetition flashcard system. Create cards from facts or text, chat with flashcards using free-text answers graded by the agent, generate quizzes from YouTube transcripts, review due cards with adaptive scheduling, and export/import decks as CSV. +Spaced-repetition flashcards: create, review, quiz, export. ## Skill metadata diff --git a/website/docs/user-guide/skills/optional/research/research-bioinformatics.md b/website/docs/user-guide/skills/optional/research/research-bioinformatics.md index dc8bbef022..084d596c7d 100644 --- a/website/docs/user-guide/skills/optional/research/research-bioinformatics.md +++ b/website/docs/user-guide/skills/optional/research/research-bioinformatics.md @@ -17,6 +17,8 @@ Gateway to 400+ genomics and computational biology skills. | Source | Optional — install with `hermes skills install official/research/bioinformatics` | | Path | `optional-skills/research/bioinformatics` | | Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos | | Tags | `bioinformatics`, `genomics`, `sequencing`, `biology`, `research`, `science` | diff --git a/website/docs/user-guide/skills/optional/research/research-domain-intel.md b/website/docs/user-guide/skills/optional/research/research-domain-intel.md index 5314b05ef5..62fdd42b4b 100644 --- a/website/docs/user-guide/skills/optional/research/research-domain-intel.md +++ b/website/docs/user-guide/skills/optional/research/research-domain-intel.md @@ -16,7 +16,11 @@ Passive recon of subdomains, SSL certs, WHOIS, and DNS. |---|---| | Source | Optional — install with `hermes skills install official/research/domain-intel` | | Path | `optional-skills/research/domain-intel` | +| Version | `1.0.0` | +| Author | FurkanL0, Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | +| Tags | `Domains`, `OSINT`, `DNS`, `Research` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/optional/research/research-drug-discovery.md b/website/docs/user-guide/skills/optional/research/research-drug-discovery.md index 7684e816eb..d636ac8b8d 100644 --- a/website/docs/user-guide/skills/optional/research/research-drug-discovery.md +++ b/website/docs/user-guide/skills/optional/research/research-drug-discovery.md @@ -1,14 +1,14 @@ --- -title: "Drug Discovery — Pharmaceutical research assistant for drug discovery workflows" +title: "Drug Discovery — Drug discovery: ChEMBL search, drug-likeness, interactions" sidebar_label: "Drug Discovery" -description: "Pharmaceutical research assistant for drug discovery workflows" +description: "Drug discovery: ChEMBL search, drug-likeness, interactions" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # Drug Discovery -Pharmaceutical research assistant for drug discovery workflows. Search bioactive compounds on ChEMBL, calculate drug-likeness (Lipinski Ro5, QED, TPSA, synthetic accessibility), look up drug-drug interactions via OpenFDA, interpret ADMET profiles, and assist with lead optimization. Use for medicinal chemistry questions, molecule property analysis, clinical pharmacology, and open-science drug research. +Drug discovery: ChEMBL search, drug-likeness, interactions. ## Skill metadata diff --git a/website/docs/user-guide/skills/optional/research/research-osint-investigation.md b/website/docs/user-guide/skills/optional/research/research-osint-investigation.md index 5fc0365838..b118a2468e 100644 --- a/website/docs/user-guide/skills/optional/research/research-osint-investigation.md +++ b/website/docs/user-guide/skills/optional/research/research-osint-investigation.md @@ -18,6 +18,7 @@ Follow the money via public records and sanctions data. | Path | `optional-skills/research/osint-investigation` | | Version | `0.1.0` | | Author | Hermes Agent (adapted from ShinMegamiBoson/OpenPlanter, MIT) | +| License | MIT | | Platforms | linux, macos, windows | | Tags | `osint`, `investigation`, `public-records`, `sec`, `sanctions`, `corporate-registry`, `property`, `courts`, `due-diligence`, `journalism` | | Related skills | [`domain-intel`](/docs/user-guide/skills/optional/research/research-domain-intel), [`arxiv`](/docs/user-guide/skills/bundled/research/research-arxiv) | diff --git a/website/docs/user-guide/skills/optional/security/security-oss-forensics.md b/website/docs/user-guide/skills/optional/security/security-oss-forensics.md index 01d601d6df..8c331a4ddc 100644 --- a/website/docs/user-guide/skills/optional/security/security-oss-forensics.md +++ b/website/docs/user-guide/skills/optional/security/security-oss-forensics.md @@ -1,17 +1,14 @@ --- -title: "Oss Forensics — Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories" +title: "Oss Forensics — GitHub supply-chain forensics: recovery, IOCs, reporting" sidebar_label: "Oss Forensics" -description: "Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories" +description: "GitHub supply-chain forensics: recovery, IOCs, reporting" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # Oss Forensics -Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories. -Covers deleted commit recovery, force-push detection, IOC extraction, multi-source evidence -collection, hypothesis formation/validation, and structured forensic reporting. -Inspired by RAPTOR's 1800+ line OSS Forensics system. +GitHub supply-chain forensics: recovery, IOCs, reporting. ## Skill metadata @@ -19,7 +16,11 @@ Inspired by RAPTOR's 1800+ line OSS Forensics system. |---|---| | Source | Optional — install with `hermes skills install official/security/oss-forensics` | | Path | `optional-skills/security/oss-forensics` | +| Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | +| Tags | `Security`, `Forensics`, `GitHub`, `Supply-Chain` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/optional/security/security-web-pentest.md b/website/docs/user-guide/skills/optional/security/security-web-pentest.md index dcd9850814..64ea3c35f5 100644 --- a/website/docs/user-guide/skills/optional/security/security-web-pentest.md +++ b/website/docs/user-guide/skills/optional/security/security-web-pentest.md @@ -1,18 +1,14 @@ --- -title: "Web Pentest" +title: "Web Pentest — Authorized web pentest: recon, proof-based exploits, report" sidebar_label: "Web Pentest" -description: "Authorized web application penetration testing — reconnaissance, vulnerability analysis, proof-based exploitation, and professional reporting" +description: "Authorized web pentest: recon, proof-based exploits, report" --- {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} # Web Pentest -Authorized web application penetration testing — reconnaissance, vulnerability -analysis, proof-based exploitation, and professional reporting. Adapts -Shannon's "No Exploit, No Report" methodology with hard guardrails for -scope, authorization, and aux-client leakage. Active testing against running -applications you own or have written authorization to test. +Authorized web pentest: recon, proof-based exploits, report. ## Skill metadata @@ -20,7 +16,11 @@ applications you own or have written authorization to test. |---|---| | Source | Optional — install with `hermes skills install official/security/web-pentest` | | Path | `optional-skills/security/web-pentest` | +| Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos | +| Tags | `Security`, `Pentest`, `Web`, `Recon` | ## Reference: full SKILL.md diff --git a/website/docs/user-guide/skills/optional/software-development/software-development-code-wiki.md b/website/docs/user-guide/skills/optional/software-development/software-development-code-wiki.md index 7d41054dea..89033235d1 100644 --- a/website/docs/user-guide/skills/optional/software-development/software-development-code-wiki.md +++ b/website/docs/user-guide/skills/optional/software-development/software-development-code-wiki.md @@ -31,7 +31,7 @@ The following is the complete skill definition that Hermes loads when this skill # Code Wiki Skill -Generate a comprehensive wiki for any codebase — overview, architecture, per-module deep-dives, Mermaid class and sequence diagrams. Inspired by Google CodeWiki, but works on local repos, private repos, and any language. Uses only existing Hermes tools (`terminal`, `read_file`, `search_files`, `write_file`); no Docker, no external services, no extra dependencies. +Generate a full wiki for any codebase — overview, architecture, per-module deep-dives, Mermaid class and sequence diagrams. Inspired by Google CodeWiki, but works on local repos, private repos, and any language. Uses only existing Hermes tools (`terminal`, `read_file`, `search_files`, `write_file`); no Docker, no external services, no extra dependencies. This skill produces **reference documentation** (what/how). It does not produce strategic narrative (why — that's a different skill). diff --git a/website/docs/user-guide/skills/optional/software-development/software-development-rest-graphql-debug.md b/website/docs/user-guide/skills/optional/software-development/software-development-rest-graphql-debug.md index 6c9f84bafc..367149a4a4 100644 --- a/website/docs/user-guide/skills/optional/software-development/software-development-rest-graphql-debug.md +++ b/website/docs/user-guide/skills/optional/software-development/software-development-rest-graphql-debug.md @@ -19,6 +19,7 @@ Debug REST/GraphQL APIs: status codes, auth, schemas, repro. | Version | `1.2.0` | | Author | eren-karakus0 | | License | MIT | +| Platforms | linux, macos, windows | | Tags | `api`, `rest`, `graphql`, `http`, `debugging`, `testing`, `curl`, `integration` | | Related skills | [`systematic-debugging`](/docs/user-guide/skills/bundled/software-development/software-development-systematic-debugging), [`test-driven-development`](/docs/user-guide/skills/bundled/software-development/software-development-test-driven-development) | diff --git a/website/docs/user-guide/skills/optional/yuanbao/yuanbao-yuanbao.md b/website/docs/user-guide/skills/optional/yuanbao/yuanbao-yuanbao.md index 3324a63ad1..2457757f8c 100644 --- a/website/docs/user-guide/skills/optional/yuanbao/yuanbao-yuanbao.md +++ b/website/docs/user-guide/skills/optional/yuanbao/yuanbao-yuanbao.md @@ -17,6 +17,8 @@ Yuanbao (元宝) groups: @mention users, query info/members. | Source | Optional — install with `hermes skills install official/yuanbao/yuanbao` | | Path | `optional-skills/yuanbao` | | Version | `1.0.0` | +| Author | Teknium (teknium1), Hermes Agent | +| License | MIT | | Platforms | linux, macos, windows | | Tags | `yuanbao`, `mention`, `at`, `group`, `members`, `元宝`, `派`, `艾特` | diff --git a/website/sidebars.ts b/website/sidebars.ts index b566ada128..259d8f7c53 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -404,6 +404,7 @@ const sidebars: SidebarsConfig = { key: 'skills-optional-devops', collapsed: true, items: [ + 'user-guide/skills/optional/devops/devops-actual-setup', 'user-guide/skills/optional/devops/devops-cli', 'user-guide/skills/optional/devops/devops-docker-management', 'user-guide/skills/optional/devops/devops-hermes-s6-container-supervision',