better-dsh 0.2.4 → 0.2.5

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/profile-commands.md

@@ -0,0 +1,544 @@
+---
+sidebar_position: 7
+---
+
+# Profile Commands Reference
+
+This page covers all commands related to [Hermes profiles](../user-guide/profiles.md). For general CLI commands, see [CLI Commands Reference](./cli-commands.md).
+
+## `hermes profile`
+
+```bash
+hermes profile <subcommand>
+```
+
+Top-level command for managing profiles. Running `hermes profile` without a subcommand shows help.
+
+| Subcommand | Description |
+|------------|-------------|
+| `list` | List all profiles. |
+| `use` | Set the active (default) profile. |
+| `create` | Create a new profile. |
+| `describe` | Read or set a profile's description (used by the kanban orchestrator for routing). |
+| `delete` | Delete a profile. |
+| `show` | Show details about a profile. |
+| `alias` | Regenerate the shell alias for a profile. |
+| `rename` | Rename a profile. |
+| `export` | Export a profile to a tar.gz archive. |
+| `import` | Import a profile from a tar.gz archive. |
+| `install` | Install a profile distribution from a git URL or local directory. See [Profile Distributions](../user-guide/profile-distributions.md). |
+| `update` | Re-pull a distribution-managed profile and re-apply its bundle. |
+| `info` | Show distribution metadata for a profile (origin URL, commit, last update). |
+
+## `hermes profile list`
+
+```bash
+hermes profile list
+```
+
+Lists all profiles. The currently active profile is marked with `*`.
+
+**Example:**
+
+```bash
+$ hermes profile list
+  default
+* work
+  dev
+  personal
+```
+
+No options.
+
+## `hermes profile use`
+
+```bash
+hermes profile use <name>
+```
+
+Sets `<name>` as the active profile. All subsequent `hermes` commands (without `-p`) will use this profile.
+
+| Argument | Description |
+|----------|-------------|
+| `<name>` | Profile name to activate. Use `default` to return to the base profile. |
+
+**Example:**
+
+```bash
+hermes profile use work
+hermes profile use default
+```
+
+## `hermes profile create`
+
+```bash
+hermes profile create <name> [options]
+```
+
+Creates a new profile.
+
+| Argument / Option | Description |
+|-------------------|-------------|
+| `<name>` | Name for the new profile. Must be a valid directory name (alphanumeric, hyphens, underscores). |
+| `--clone` | Copy `config.yaml`, `.env`, `SOUL.md`, skills, and the curated `memories/MEMORY.md` / `memories/USER.md` from the current profile. Sessions, `state.db` and cron jobs are not copied. |
+| `--clone-all` | Copy everything (config, memories, skills, plugins) from the current profile. Excludes per-profile history: sessions, `state.db`, backups, state-snapshots, checkpoints — and cron jobs, which stay bound to the source profile (a clone that inherited them would fire every job twice). When the source is the default profile, the machine-scoped local-model trees (`models/`, `runtimes/`, `node/`) are also skipped — the same trees `hermes backup` excludes. |
+| `--clone-from <profile>` | Clone config/skills/SOUL from a specific profile instead of the current one. Implies `--clone` unless paired with `--clone-all`. |
+| `--no-alias` | Skip wrapper script creation. |
+| `--description "<text>"` | One- or two-sentence description of what this profile is good at. Used by the kanban orchestrator to route tasks based on role instead of profile name alone. Skip and add later via `hermes profile describe`. Persisted in `<profile_dir>/profile.yaml`. |
+| `--no-skills` | Create an **empty** profile with zero bundled skills enabled. Writes a `.no-bundled-skills` marker into the profile so future `hermes update` runs won't re-seed the bundled set, and refuses to combine with `--clone`, `--clone-from`, or `--clone-all` (which would copy skills in anyway). Useful for narrow orchestrator profiles or sandbox profiles that should not inherit the full skill catalog. To toggle this on an already-created profile (including the default `~/.hermes`), use `hermes skills opt-out` / `hermes skills opt-in`. |
+
+Creating a profile does **not** make that profile directory the default project/workspace directory for terminal commands. If you want a profile to start in a specific project, set `terminal.cwd` in that profile's `config.yaml`.
+
+**Examples:**
+
+```bash
+# Blank profile — needs full setup
+hermes profile create mybot
+
+# Clone config only from current profile
+hermes profile create work --clone
+
+# Clone everything from current profile
+hermes profile create backup --clone-all
+
+# Clone config from a specific profile
+hermes profile create work2 --clone-from work
+
+# Clone everything from a specific profile
+hermes profile create work2-backup --clone-from work --clone-all
+```
+
+## `hermes profile describe`
+
+```bash
+hermes profile describe [<name>] [options]
+```
+
+Read or set a profile's description. The description is consumed by the kanban orchestrator to route tasks based on what each profile is good at, rather than guessing from the profile name alone. Persisted in `<profile_dir>/profile.yaml` so it survives reboots and is shared with the gateway.
+
+With no flags, prints the current description (or `(no description set for '<name>')` if empty).
+
+| Argument / Option | Description |
+|-------------------|-------------|
+| `<name>` | Profile to describe. Required unless `--all --auto` is used. |
+| `--text "<text>"` | Set the description to this exact text (user-authored). Overwrites any existing description. |
+| `--auto` | Auto-generate a 1-2 sentence description via the auxiliary LLM, based on the profile's installed skills, configured model, and name. Configure the model under `auxiliary.profile_describer` in `config.yaml`. Auto-generated descriptions are marked `description_auto: true` so the dashboard can flag them for review. |
+| `--overwrite` | With `--auto`, replace user-authored descriptions too (default: skip profiles whose description was set explicitly). |
+| `--all` | With `--auto`, sweep every profile missing a description. |
+
+**Examples:**
+
+```bash
+# Read the current description
+hermes profile describe researcher
+
+# Set it explicitly
+hermes profile describe researcher --text "Reads source code and writes findings."
+
+# Let the LLM generate one
+hermes profile describe researcher --auto
+
+# Fill in descriptions for every profile that doesn't have one
+hermes profile describe --all --auto
+```
+
+## `hermes profile delete`
+
+```bash
+hermes profile delete <name> [options]
+```
+
+Deletes a profile and removes its shell alias.
+
+| Argument / Option | Description |
+|-------------------|-------------|
+| `<name>` | Profile to delete. |
+| `--yes`, `-y` | Skip confirmation prompt. |
+
+**Example:**
+
+```bash
+hermes profile delete mybot
+hermes profile delete mybot --yes
+```
+
+:::warning
+This permanently deletes the profile's entire directory including all config, memories, sessions, and skills. The `default` profile (`~/.hermes`) cannot be deleted — use `hermes uninstall` to remove everything.
+:::
+
+## `hermes profile show`
+
+```bash
+hermes profile show <name>
+```
+
+Displays details about a profile including its home directory, configured model, gateway status, skills count, and configuration file status.
+
+This shows the profile's Hermes home directory, not the terminal working directory. Terminal commands start from `terminal.cwd` (or the launch directory on the local backend when `cwd: "."`).
+
+| Argument | Description |
+|----------|-------------|
+| `<name>` | Profile to inspect. |
+
+**Example:**
+
+```bash
+$ hermes profile show work
+Profile: work
+Path:    ~/.hermes/profiles/work
+Model:   anthropic/claude-sonnet-4 (anthropic)
+Gateway: stopped
+Skills:  12
+.env:    exists
+SOUL.md: exists
+Alias:   ~/.local/bin/work
+```
+
+## `hermes profile alias`
+
+```bash
+hermes profile alias <name> [options]
+```
+
+Regenerates the shell alias script at `~/.local/bin/<name>`. Useful if the alias was accidentally deleted or if you need to update it after moving your Hermes installation.
+
+| Argument / Option | Description |
+|-------------------|-------------|
+| `<name>` | Profile to create/update the alias for. |
+| `--remove` | Remove the wrapper script instead of creating it. |
+| `--name <alias>` | Custom alias name (default: profile name). |
+
+**Example:**
+
+```bash
+hermes profile alias work
+# Creates/updates ~/.local/bin/work
+
+hermes profile alias work --name mywork
+# Creates ~/.local/bin/mywork
+
+hermes profile alias work --remove
+# Removes the wrapper script
+```
+
+## `hermes profile rename`
+
+```bash
+hermes profile rename <old-name> <new-name>
+```
+
+Renames a profile. Updates the directory and shell alias.
+
+| Argument | Description |
+|----------|-------------|
+| `<old-name>` | Current profile name. |
+| `<new-name>` | New profile name. |
+
+**Example:**
+
+```bash
+hermes profile rename mybot assistant
+# ~/.hermes/profiles/mybot → ~/.hermes/profiles/assistant
+# ~/.local/bin/mybot → ~/.local/bin/assistant
+```
+
+The rename also migrates the profile's persisted session/routing identity — session keys
+(`agent:<old>:*`), `sessions.profile_name`, heartbeats, and routing/delivery rows — to the new
+name. A live multiplexed gateway owns that migration (it holds the routing index in memory), so
+when it is running the CLI delegates to it.
+
+## `hermes profile migrate-identity`
+
+```bash
+hermes profile migrate-identity <old-name> <new-name>
+```
+
+Retries the identity migration of a rename that already completed. Run it if `hermes profile
+rename` warned that the live gateway could not migrate session identity: restart the gateway
+(it reloads the routing index from the database, so the migration lands), or stop it — with no
+gateway holding the store the command performs the durable rewrite itself.
+
+The migration is driven by the rows that still name `<old>`, so `profiles/<old>` does not have
+to exist; only `<new>` is checked. Idempotent — re-running a completed migration succeeds with
+nothing left to rekey. Exits non-zero when a live gateway refuses the migration, when a
+database rejects the rewrite (a routing collision, a lock, or one of the two databases failing
+while the other succeeds), naming the database and error.
+
+**Example:**
+
+```bash
+hermes profile rename mybot assistant
+# ⚠ Profile was renamed, but the live gateway could not migrate session identity (…).
+#   Restart the gateway, then run:
+#     hermes profile migrate-identity mybot assistant
+
+hermes profile migrate-identity mybot assistant
+# ✓ Session/routing identity migrated: mybot → assistant
+```
+
+## `hermes profile export`
+
+```bash
+hermes profile export <name> [options]
+```
+
+Exports a profile as a compressed tar.gz archive — a portable snapshot you can back up, move to another machine, or hand to someone else. `auth.json` and `.env` are always excluded.
+
+Also available in chat as [`/export`](./slash-commands.md), and in the desktop app via **⌘K → Export profile…** or a profile square's right-click menu. A desktop export additionally stages `desktop.json` (skin, light/dark mode, custom themes, rail color, window layout) into the archive.
+
+| Argument / Option | Description |
+|-------------------|-------------|
+| `<name>` | Profile to export. |
+| `-o`, `--output <path>` | Output file path (default: `<name>.tar.gz`). |
+
+**Example:**
+
+```bash
+hermes profile export work
+# Creates work.tar.gz in the current directory
+
+hermes profile export work -o ./work-2026-03-29.tar.gz
+```
+
+See [Export and import a profile file](../user-guide/profile-distributions.md#export-and-import-a-profile-file) for exactly what lands in the archive and what to check before sending one to someone else.
+
+## `hermes profile import`
+
+```bash
+hermes profile import <archive> [options]
+```
+
+Imports a profile from a tar.gz archive, as a new profile. Refuses to overwrite an existing profile, and cannot import as `default` (the built-in root profile) — pass `--name` in either case. A shell wrapper is created when the name doesn't collide with an existing command.
+
+Also available in chat as [`/import`](./slash-commands.md), and in the desktop app via **⌘K → Import profile…** or the import button beside the profile rail's **+**. A desktop import also applies any bundled `desktop.json` overlay (theme, layout) and switches you into the new profile.
+
+| Argument / Option | Description |
+|-------------------|-------------|
+| `<archive>` | Path to the tar.gz archive to import. |
+| `--name <name>` | Name for the imported profile (default: inferred from archive). |
+
+**Example:**
+
+```bash
+hermes profile import ./work-2026-03-29.tar.gz
+# Infers profile name from the archive
+
+hermes profile import ./work-2026-03-29.tar.gz --name work-restored
+```
+
+## Distribution commands
+
+:::tip
+**New to distributions?** Start with the [Profile Distributions user guide](../user-guide/profile-distributions.md) — it covers the why, when, and how with full examples. The sections below are a dry CLI reference for when you know what you want.
+:::
+
+Distributions turn a profile into a shareable, versioned artifact published
+as a **git repository**. A recipient installs the distribution with a single
+command and can update it in place later without touching their local
+memories, sessions, or credentials.
+
+`auth.json` and `.env` are never part of a distribution — they stay on the
+installing user's machine.
+
+The recipient's user data (memories, sessions, auth, their own edits to
+`.env`) is always preserved across the initial install and subsequent
+updates.
+
+:::info
+Two ways to share a profile, and they complement each other. `hermes profile export` / `import` (also `/export` and `/import` in chat) produce a **single file** — no repo, no manifest, and a desktop export carries your theme and layout too. Distribution (`install` / `update` / `info`) publishes a profile as a **git repo** so recipients can pull versioned updates later. Backup and restore is the export file's other job. See [Two ways to share a profile](../user-guide/profile-distributions.md#two-ways-to-share-a-profile).
+:::
+
+### `hermes profile install`
+
+```bash
+hermes profile install <source> [--name <name>] [--alias] [--force] [--yes]
+```
+
+Installs a profile distribution from a git URL or a local directory.
+
+| Option | Description |
+|--------|-------------|
+| `<source>` | Git URL (`github.com/user/repo`, `https://...`, `git@...`, `ssh://`, `git://`) or a local directory containing `distribution.yaml` at its root. |
+| `--name NAME` | Override the profile name from the manifest. |
+| `--alias` | Also create a shell wrapper (e.g. `telemetry` → `hermes -p telemetry`). |
+| `--force` | Overwrite an existing profile of the same name. User data is still preserved. |
+| `-y`, `--yes` | Skip the manifest-preview confirmation prompt. |
+
+The installer shows the manifest, lists required env vars, and warns about
+cron jobs before asking for confirmation. Required env vars go into a
+`.env.EXAMPLE` file you copy to `.env` and fill in.
+
+**Examples:**
+
+```bash
+# Install from a GitHub repo (shorthand)
+hermes profile install github.com/kyle/telemetry-distribution --alias
+
+# Install from a full HTTPS git URL
+hermes profile install https://github.com/kyle/telemetry-distribution.git
+
+# Install from SSH
+hermes profile install git@github.com:kyle/telemetry-distribution.git
+
+# Install from a local directory during development
+hermes profile install ./telemetry/
+```
+
+### `hermes profile update`
+
+```bash
+hermes profile update <name> [--force-config] [--yes]
+```
+
+Re-clones the distribution from its recorded source and applies updates.
+Distribution-owned files (SOUL.md, mcp.json) are overwritten and the
+skills and cron jobs the distribution ships are replaced; skills or cron
+jobs you added under `skills/` or `cron/` yourself stay in place. User data
+(memories, sessions, auth, .env) is never touched. A symlinked `skills/`,
+`cron/` or skill category directory is refused before anything is written — replace the link with a real
+directory and re-run.
+
+`config.yaml` is preserved by default to keep your local overrides.
+Pass `--force-config` to reset it to the distribution's shipped config.
+
+### `hermes profile info`
+
+```bash
+hermes profile info <name>
+```
+
+Prints the profile's distribution manifest — name, version, required
+Hermes version, author, env var requirements, the source URL/path, and
+the `Installed:` timestamp recorded when the distribution was last
+`install`-ed or `update`-d. Useful for checking what a shared profile
+needs before installing it, and for spotting "this profile was installed
+6 months ago and hasn't been updated."
+
+`hermes profile list` also shows the distribution name and version in a
+`Distribution` column, and `hermes profile show <name>` / `delete <name>`
+surface the source URL so you can tell at a glance which profiles came
+from a git repo vs. were created locally.
+
+### Private distributions
+
+A private git repository works as a distribution source with no extra
+configuration — the install shells out to your normal `git` binary, so
+whatever authentication your shell is already set up for (SSH key,
+`git credential` helper, GitHub CLI's stored HTTPS credentials) applies
+transparently.
+
+```bash
+# Uses your SSH key, the same as any other `git clone`
+hermes profile install git@github.com:your-org/internal-assistant.git
+
+# Uses your git credential helper
+hermes profile install https://github.com/your-org/internal-assistant.git
+```
+
+If a clone prompts for credentials interactively in your terminal during
+install, that prompt flows through. Set up your auth the way you'd
+normally use `git clone` against the same repo first, then install.
+
+### Distribution manifest (`distribution.yaml`)
+
+Every distribution has a `distribution.yaml` at the root of its repository:
+
+```yaml
+name: telemetry
+version: 0.1.0
+description: "Compliance monitoring harness"
+hermes_requires: ">=0.12.0"
+author: "Your Name"
+license: "MIT"
+env_requires:
+  - name: OPENAI_API_KEY
+    description: "OpenAI API key"
+    required: true
+  - name: GRAPHITI_MCP_URL
+    description: "Memory graph URL"
+    required: false
+    default: "http://127.0.0.1:8000/sse"
+distribution_owned:   # optional; defaults to SOUL.md, config.yaml,
+                      #   mcp.json, skills/, cron/, distribution.yaml
+  - SOUL.md
+  - skills/compliance/
+  - cron/
+```
+
+`hermes_requires` supports `>=`, `<=`, `==`, `!=`, `>`, `<`, or a bare
+version (treated as `>=`). Install fails with a clear error if the current
+Hermes version doesn't satisfy the spec.
+
+`distribution_owned` is optional. If set, only those paths are replaced on
+update; anything else in the profile stays user-owned. If omitted, the
+defaults above apply.
+
+### Publishing a distribution
+
+Authoring a distribution is just a git push:
+
+1. In your profile directory, create `distribution.yaml` with at least `name`
+   and `version`.
+2. Initialize a git repo (or use an existing one) and push to GitHub /
+   GitLab / any host Hermes can clone from.
+3. Tell recipients to run `hermes profile install <your-repo-url>`.
+
+Use git tags for versioned releases — recipients who clone `HEAD` get your
+latest state, and you can always bump `version:` in the manifest.
+
+## `hermes -p` / `hermes --profile`
+
+```bash
+hermes -p <name> <command> [options]
+hermes --profile <name> <command> [options]
+```
+
+Global flag to run any Hermes command under a specific profile without changing the sticky default. This overrides the active profile for the duration of the command.
+
+| Option | Description |
+|--------|-------------|
+| `-p <name>`, `--profile <name>` | Profile to use for this command. |
+
+**Examples:**
+
+```bash
+hermes -p work chat -q "Check the server status"
+hermes --profile dev gateway start
+hermes -p personal skills list
+hermes -p work config edit
+```
+
+## `hermes completion`
+
+```bash
+hermes completion <shell>
+```
+
+Generates shell completion scripts. Includes completions for profile names and profile subcommands.
+
+| Argument | Description |
+|----------|-------------|
+| `<shell>` | Shell to generate completions for: `bash`, `zsh`, or `fish`. |
+
+**Examples:**
+
+```bash
+# Install completions
+hermes completion bash >> ~/.bashrc
+hermes completion zsh >> ~/.zshrc
+hermes completion fish > ~/.config/fish/completions/hermes.fish
+
+# Reload shell
+source ~/.bashrc
+```
+
+After installation, tab completion works for:
+- `hermes profile <TAB>` — subcommands (list, use, create, etc.)
+- `hermes profile use <TAB>` — profile names
+- `hermes -p <TAB>` — profile names
+
+## See also
+
+- [Profiles User Guide](../user-guide/profiles.md)
+- [CLI Commands Reference](./cli-commands.md)
+- [FAQ — Profiles section](./faq.md#profiles)

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/skills-catalog.md

@@ -0,0 +1,132 @@
+---
+sidebar_position: 5
+title: "Bundled Skills Catalog"
+description: "Catalog of bundled skills that ship with Hermes Agent"
+---
+
+# Bundled Skills Catalog
+
+Hermes ships with a large built-in skill library copied into `~/.hermes/skills/` on install. Each skill below links to a dedicated page with its full definition, setup, and usage.
+
+Hermes also syncs bundled skills on `hermes update`, but the sync manifest respects local deletions and user edits. If a skill listed here is missing from your profile's `~/.hermes/skills/` tree, it is still shipped with Hermes; restore it with `hermes skills reset <name> --restore`.
+
+If a skill is missing from this list but present in the repo, the catalog is regenerated by `website/scripts/generate-skill-docs.py`.
+
+## apple
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`apple-notes`](/docs/user-guide/skills/bundled/apple/apple-apple-notes) | Manage Apple Notes via memo CLI: create, search, edit. | `apple\apple-notes` |
+| [`apple-reminders`](/docs/user-guide/skills/bundled/apple/apple-apple-reminders) | Apple Reminders via remindctl: add, list, complete. | `apple\apple-reminders` |
+| [`findmy`](/docs/user-guide/skills/bundled/apple/apple-findmy) | Track Apple devices/AirTags via FindMy.app on macOS. | `apple\findmy` |
+| [`imessage`](/docs/user-guide/skills/bundled/apple/apple-imessage) | Send and receive iMessages/SMS via the imsg CLI on macOS. | `apple\imessage` |
+
+## autonomous-ai-agents
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`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 desktop background-first; escalate on signal. | `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` |
+| [`merge-reconciler`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-merge-reconciler) | Neutral third-party resolution of agent merge conflicts. | `autonomous-ai-agents\merge-reconciler` |
+| [`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` |
+
+## creative
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`architecture-diagram`](/docs/user-guide/skills/bundled/creative/creative-architecture-diagram) | Dark-themed SVG architecture/cloud/infra diagrams as HTML. | `creative\architecture-diagram` |
+| [`ascii-video`](/docs/user-guide/skills/bundled/creative/creative-ascii-video) | ASCII video: convert video/audio to colored ASCII MP4/GIF. | `creative\ascii-video` |
+| [`baoyu-infographic`](/docs/user-guide/skills/bundled/creative/creative-baoyu-infographic) | Infographics: 21 layouts x 21 styles (信息图, 可视化). | `creative\baoyu-infographic` |
+| [`claude-design`](/docs/user-guide/skills/bundled/creative/creative-claude-design) | Design one-off HTML artifacts (landing, deck, prototype). | `creative\claude-design` |
+| [`design-md`](/docs/user-guide/skills/bundled/creative/creative-design-md) | Author/validate/export Google's DESIGN.md token spec files. | `creative\design-md` |
+| [`humanizer`](/docs/user-guide/skills/bundled/creative/creative-humanizer) | Humanize text: strip AI-isms and add real voice. | `creative\humanizer` |
+| [`manim-video`](/docs/user-guide/skills/bundled/creative/creative-manim-video) | Manim CE animations: 3Blue1Brown math/algo videos. | `creative\manim-video` |
+| [`p5js`](/docs/user-guide/skills/bundled/creative/creative-p5js) | p5.js sketches: gen art, shaders, interactive, 3D. | `creative\p5js` |
+| [`popular-web-designs`](/docs/user-guide/skills/bundled/creative/creative-popular-web-designs) | 54 real design systems (Stripe, Linear, Vercel) as HTML/CSS. | `creative\popular-web-designs` |
+| [`songwriting-and-ai-music`](/docs/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music) | Songwriting craft and Suno AI music prompts. | `creative\songwriting-and-ai-music` |
+
+## devops
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`sdlc-review`](/docs/user-guide/skills/bundled/devops/devops-sdlc-review) | Review Kanban handoffs and route verified outcomes. | `devops\sdlc-review` |
+
+## email
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`email-inbox-triage`](/docs/user-guide/skills/bundled/email/email-email-inbox-triage) | Triage an inbox: prioritize threads, draft replies safely. | `email\email-inbox-triage` |
+| [`himalaya`](/docs/user-guide/skills/bundled/email/email-himalaya) | Himalaya CLI: IMAP/SMTP email from terminal. | `email\himalaya` |
+
+## media
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`gif-search`](/docs/user-guide/skills/bundled/media/media-gif-search) | Search/download GIFs from Tenor via curl + jq. | `media\gif-search` |
+| [`songsee`](/docs/user-guide/skills/bundled/media/media-songsee) | Audio spectrograms/features (mel, chroma, MFCC) via CLI. | `media\songsee` |
+| [`youtube-content`](/docs/user-guide/skills/bundled/media/media-youtube-content) | YouTube transcripts to summaries, threads, blogs. | `media\youtube-content` |
+
+## note-taking
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`obsidian`](/docs/user-guide/skills/bundled/note-taking/note-taking-obsidian) | Read, search, create, and edit notes in the Obsidian vault. | `note-taking\obsidian` |
+
+## productivity
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`airtable`](/docs/user-guide/skills/bundled/productivity/productivity-airtable) | Airtable REST API via curl. Records CRUD, filters, upserts. | `productivity\airtable` |
+| [`box`](/docs/user-guide/skills/bundled/productivity/productivity-box) | Box manages cloud files, sharing, search, and metadata. | `productivity\box` |
+| [`document-to-action-items`](/docs/user-guide/skills/bundled/productivity/productivity-document-to-action-items) | Extract cited obligations, deadlines, tasks from documents. | `productivity\document-to-action-items` |
+| [`docx`](/docs/user-guide/skills/bundled/productivity/productivity-docx) | Create, read, edit, template, and review Word .docx files. | `productivity\docx` |
+| [`google-workspace`](/docs/user-guide/skills/bundled/productivity/productivity-google-workspace) | Gmail, Calendar, Drive, Docs, Sheets via gws CLI or Python. | `productivity\google-workspace` |
+| [`maps`](/docs/user-guide/skills/bundled/productivity/productivity-maps) | Geocode, POIs, routes, timezones via OpenStreetMap/OSRM. | `productivity\maps` |
+| [`meeting-action-items`](/docs/user-guide/skills/bundled/productivity/productivity-meeting-action-items) | Turn meeting notes into cited decisions, owners, tickets. | `productivity\meeting-action-items` |
+| [`notion`](/docs/user-guide/skills/bundled/productivity/productivity-notion) | Notion API + ntn CLI: pages, databases, markdown, Workers. | `productivity\notion` |
+| [`pdf`](/docs/user-guide/skills/bundled/productivity/productivity-pdf) | PDF files: create, read, merge, fill, OCR, edit text. | `productivity\pdf` |
+| [`powerpoint`](/docs/user-guide/skills/bundled/productivity/productivity-powerpoint) | Create, read, edit .pptx decks with python-pptx. | `productivity\powerpoint` |
+| [`product-price-monitor`](/docs/user-guide/skills/bundled/productivity/productivity-product-price-monitor) | Watch product, flight, or listing prices; alert on target. | `productivity\product-price-monitor` |
+| [`teams-meeting-pipeline`](/docs/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline) | Teams meeting summaries, job replay, Graph subscriptions. | `productivity\teams-meeting-pipeline` |
+| [`weekly-review-planning`](/docs/user-guide/skills/bundled/productivity/productivity-weekly-review-planning) | Weekly reset: commitments, stalled work, next-week plan. | `productivity\weekly-review-planning` |
+| [`xlsx`](/docs/user-guide/skills/bundled/productivity/productivity-xlsx) | Create, read, edit Excel .xlsx workbooks and CSVs. | `productivity\xlsx` |
+
+## research
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`arxiv`](/docs/user-guide/skills/bundled/research/research-arxiv) | Search arXiv papers by keyword, author, category, or ID. | `research\arxiv` |
+| [`competitor-news-monitor`](/docs/user-guide/skills/bundled/research/research-competitor-news-monitor) | Watch named companies for material news; cited digests. | `research\competitor-news-monitor` |
+| [`grounded-citations`](/docs/user-guide/skills/bundled/research/research-grounded-citations) | Ground answers and documents in cited, verifiable sources. | `research\grounded-citations` |
+| [`llm-wiki`](/docs/user-guide/skills/bundled/research/research-llm-wiki) | Karpathy's LLM Wiki: build/query interlinked markdown KB. | `research\llm-wiki` |
+
+## social-media
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`xurl`](/docs/user-guide/skills/bundled/social-media/social-media-xurl) | X/Twitter via xurl CLI: raw post search, posting, DM, media. | `social-media\xurl` |
+
+## software-development
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`codebase-inspection`](/docs/user-guide/skills/bundled/software-development/software-development-codebase-inspection) | Inspect codebases w/ pygount: LOC, languages, ratios. | `software-development\codebase-inspection` |
+| [`dogfood`](/docs/user-guide/skills/bundled/software-development/software-development-dogfood) | Exploratory QA of web apps: find bugs, evidence, reports. | `software-development\dogfood` |
+| [`github`](/docs/user-guide/skills/bundled/software-development/software-development-github) | GitHub via gh CLI: PRs, issues, reviews, repos, auth. | `software-development\github` |
+| [`hermes-agent-skill-authoring`](/docs/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring) | Author in-repo SKILL.md files: frontmatter and structure. | `software-development\hermes-agent-skill-authoring` |
+| [`inspecting-hermes-desktop-dom`](/docs/user-guide/skills/bundled/software-development/software-development-inspecting-hermes-desktop-dom) | Read the live Hermes desktop DOM/CSS over CDP. | `software-development\inspecting-hermes-desktop-dom` |
+| [`node-inspect-debugger`](/docs/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger) | Debug Node.js via --inspect + Chrome DevTools Protocol CLI. | `software-development\node-inspect-debugger` |
+| [`python-debugpy`](/docs/user-guide/skills/bundled/software-development/software-development-python-debugpy) | Debug Python: pdb REPL + debugpy remote (DAP). | `software-development\python-debugpy` |
+| [`requesting-code-review`](/docs/user-guide/skills/bundled/software-development/software-development-requesting-code-review) | Pre-commit review: security scan, quality gates, auto-fix. | `software-development\requesting-code-review` |
+| [`simplify-code`](/docs/user-guide/skills/bundled/software-development/software-development-simplify-code) | Parallel 4-agent cleanup of recent code changes. | `software-development\simplify-code` |
+| [`spike`](/docs/user-guide/skills/bundled/software-development/software-development-spike) | Throwaway experiments to validate an idea before build. | `software-development\spike` |
+| [`systematic-debugging`](/docs/user-guide/skills/bundled/software-development/software-development-systematic-debugging) | 4-phase root cause debugging: understand bugs before fixing. | `software-development\systematic-debugging` |
+| [`test-driven-development`](/docs/user-guide/skills/bundled/software-development/software-development-test-driven-development) | TDD: enforce RED-GREEN-REFACTOR, tests before code. | `software-development\test-driven-development` |
+
+## web
+
+| Skill | Description | Path |
+|-------|-------------|------|
+| [`blocked-page-recovery`](/docs/user-guide/skills/bundled/web/web-blocked-page-recovery) | Use when a fetch fails: 403/429, paywall, WAF, bot wall. | `web\blocked-page-recovery` |