Skip to content
Back to search

donna-starter

Donna — a starter Hermes Agent profile: opinionated persona, 73 curated skills, guided first-run orientation, optional Token Router. MIT.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/atlasomnia--donna-starter/badge.svg)](/listings/atlasomnia--donna-starter)

HTML

<a href="/listings/atlasomnia--donna-starter"><img src="/api/listings/atlasomnia--donna-starter/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

mkdir -p ~/.hermes/profiles
git clone https://github.com/AtlasOmnia/donna-starter.git ~/.hermes/profiles/donna

This repository *is* the profile — clone it straight into your Hermes profiles directory under the name `donna`. Updates later are just `git -C ~/.hermes/profiles/donna pull`.

Then:

hermes setup                  # add your model provider key — or skip if another
                              # Hermes profile already has one (see step 4 below)
hermes --profile donna chat   # start chatting — Donna offers the orientation
hermes update                 # once: sync the standard Hermes skill library

The standard library (documents, spreadsheets, PDFs, email, travel, planning, and more) syncs into the profile automatically on `hermes update`. The curated Donna skills are tracked as user-modified and are never overwritten.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 233 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Donna — a starter Hermes profile
  2. > Part of the AtlasOmnia Hermes Agent toolset → [hermesagenttools.com/hermes-agent/](https://hermesagenttools.com/hermes-agent/)
  3. ![Donna](assets/donna.png)
  4. Donna is a pre-configured [Hermes Agent](https://hermes-agent.nousresearch.com/docs)
  5. profile for people who want a capable, opinionated assistant without building one
  6. from scratch. Clone it, point it at a model provider, and a guided first-run
  7. orientation walks you through enabling exactly the capabilities you want.
  8. She ships with:
  9. - **A persona** — sharp, discreet, outcome-focused executive assistant (see `SOUL.md`).
  10. - **72 curated skills** — Hermes configuration, plugin development, research,
  11. documents, GitHub workflows, Reddit, trip planning, local models, and more
  12. (full list below).
  13. - **A guided first-run orientation** — the `hermes-starter-onboarding` skill asks
  14. who you are, then walks you through **every toolset one at a time**, sets up web
  15. search, memory, and any integrations you choose. Nothing is enabled silently.
  16. - **The Hermes Token Router** — an optional plugin that narrows the tool surface
  17. the model sees on each turn. **Installed but disabled by default** — turn it on
  18. during orientation (details below).
  19. - **A skin and profile avatar** — `skins/donna.yaml`, `assets/donna-profile.png`.
  20. No API keys, credentials, sessions, or personal memory are included. The profile
  21. starts with generic community defaults and learns what you tell it.
  22. ## Requirements
  23. - Hermes Agent installed (`hermes --version` — see the
  24. [docs](https://hermes-agent.nousresearch.com/docs))
  25. - macOS recommended; several skills are macOS-specific
  26. - A model provider account (DeepSeek, OpenAI, Anthropic, a local server, …)
  27. ## Install
  28. ```bash
  29. mkdir -p ~/.hermes/profiles
  30. git clone https://github.com/AtlasOmnia/donna-starter.git ~/.hermes/profiles/donna
  31. ```
  32. This repository *is* the profile — clone it straight into your Hermes profiles
  33. directory under the name `donna`. Updates later are just
  34. `git -C ~/.hermes/profiles/donna pull`.
  35. Then:
  36. ```bash
  37. hermes setup # add your model provider key — or skip if another
  38. # Hermes profile already has one (see step 4 below)
  39. hermes --profile donna chat # start chatting — Donna offers the orientation
  40. hermes update # once: sync the standard Hermes skill library
  41. ```
  42. The standard library (documents, spreadsheets, PDFs, email, travel, planning, and
  43. more) syncs into the profile automatically on `hermes update`. The curated Donna
  44. skills are tracked as user-modified and are never overwritten.
  45. ## First-run orientation
  46. On your first conversation, Donna offers a guided setup. Say yes (or just ask
  47. *"help me set up my profile"* any time) to run it.
  48. It covers, in order:
  49. 1. **Identity** — what Donna calls you, what you call her, reply style.
  50. 2. **Your main jobs** — research, writing, coding, notes, organization, voice, etc.,
  51. so she can point you at the capabilities and integrations that matter to you.
  52. 3. **Toolset review** — every CLI toolset is **already enabled by default**, so the
  53. profile works out of the box. Donna walks each one in plain language — `web`,
  54. `browser`, `terminal`, `file`, `code_execution`, `computer_use`, `memory`,
  55. `session_search`, `delegation`, `skills`, `cronjob`, `todo`, `kanban`,
  56. `image_gen`, `video_gen`, `vision`, `tts`, `video`, `clarify` — and you peel
  57. back only the ones you don't want. Toolsets that need a backend or key are not
  58. reported as working until that dependency is actually present.
  59. 4. **Model provider** — if you already have a provider working in another Hermes
  60. profile, Donna offers to reuse it (keys live in `.env`; a global key is picked
  61. up automatically, so there's often nothing to re-enter) instead of making you
  62. set one up from scratch. Otherwise you add one through `hermes setup`.
  63. 5. **Web search backend** — `web` needs a search provider. Choose self-hosted
  64. **SearXNG** (private, no key — you supply your own instance URL), a hosted
  65. search API (Brave / Tavily / Exa), or let `hermes setup` walk the choice.
  66. Verified with a real query before it's called working.
  67. 6. **Memory** — Donna asks whether you already have a memory provider. If not, she
  68. recommends **Mnemosyne** (local-first, profile-scoped, no external account — the
  69. provider her memory skills are written around) and sets it up, or uses your own.
  70. 7. **Integrations** — Obsidian, calendar, reminders, email, voice — only the ones
  71. you pick, each pausing at its own credential/permission gate.
  72. 8. **Token Router (optional)** — offered here; see the next section.
  73. 9. **Optional scheduled jobs** — daily briefing, wellness check-in, health
  74. reminders, stock quotes. None are created by default.
  75. ## The Token Router (optional, off by default)
  76. Hermes exposes a large tool surface, and every tool schema costs the model
  77. attention on every turn. The bundled **Hermes Token Router** plugin narrows that
  78. surface: on the first turn it predicts which toolsets your request needs and
  79. exposes only those, keeping the rest out of the prompt. It fails open (if unsure,
  80. it shows everything) and can recover a tool mid-session if one turns out to be
  81. needed.
  82. It is **installed but disabled by default**, so the profile works identically to
  83. stock Hermes until you opt in. The orientation offers to enable it for you. To do
  84. it manually:
  85. 1. Add `hermes-token-router` to `plugins.enabled` in `config.yaml`.
  86. 2. Set `enabled: true` for your profile in `plugins/hermes-token-router/config.yaml`.
  87. 3. Start a fresh session.
  88. **It works best alongside a hosted provider API.** Out of the box the router is
  89. fully deterministic (no network call) and already trims the surface, but its
  90. optional classifier — which resolves ambiguous requests the deterministic rules
  91. can't — is designed to run against a cheap hosted model. **OpenRouter** is the
  92. natural fit: one API key gives you access to many low-cost models for the
  93. classifier. Any OpenAI-compatible provider or a local endpoint works too. The
  94. classifier is opt-in (`classifier.enabled` in the plugin config); leave it off to
  95. stay fully deterministic.
  96. Leave the router off entirely if you prefer the full tool surface always visible,
  97. or if you run a model that handles large tool contexts well.
  98. ## What's loaded — the skill library
  99. 72 skills, organized by category. Each is a reusable procedure Donna loads when
  100. the matching task comes up — you do not call them by hand.
  101. ### Getting the most out of Hermes
  102. - **hermes-starter-onboarding** — the guided first-run setup (orientation)
  103. - **hermes-agent** — configure, extend, and troubleshoot Hermes itself
  104. - **hermes-config-editing** — change settings, compression, providers safely
  105. - **hermes-context-optimization** — trim startup/context cost
  106. - **hermes-session-maintenance** — manage session history and storage
  107. - **hermes-self-evaluation** — audit and optimize your own setup
  108. - **hermes-overnight-autonomy** — unattended continuity and watchdogs
  109. - **hermes-plugin-development** / **hermes-plugin-evaluation** / **hermes-desktop-plugins** — build and vet plugins
  110. - **hermes-themes** — author color themes
  111. - **hermes-mnemosyne** / **mnemosyne-maintenance** — the memory provider
  112. - **messaging-gateway-troubleshooting** — Telegram/Discord/etc. adapter issues
  113. - **skill-auditor** — grade and review skills
  114. - **hermes-nightly-self-check-decisions** — record self-check decisions
  115. ### Research & verification
  116. - **source-verification** — separate what a source says from what you infer
  117. - **hf-model-card-research** — benchmark and quality metadata for models
  118. - **local-model-selection** — pick local LLMs by VRAM tier and use case
  119. - **external-model-review** — reproducible independent plan/code reviews
  120. - **daily-news-digests** — scheduled news/research digests
  121. - **dynamic-content-extraction** — pull data from JS-heavy sites
  122. - **site-mapping** — map a website's full structure
  123. - **local-discovery** — find local events and venues
  124. - **marketplace-purchase-vetting** — vet Marketplace/Craigslist listings
  125. - **evidence-based-replies** — check a claim against its cited source
  126. ### Documents & productivity
  127. - **google-workspace** — Gmail, Calendar, Drive, Docs, Sheets
  128. - **notion** — Notion via API/CLI
  129. - **obsidian** / **daily-note-wrapup** / **vault-organization** — notes, vault structure (PARA) & cleanup
  130. - **office-document-review** — proofread office documents
  131. - **maps** — geocoding, POIs, routes, timezones
  132. - **domestic-trip-planning** / **destination-trip-planning** — trip research
  133. - **discord-connect** — put Hermes on Discord
  134. - **session-artifact-indexing** — index what a session produced
  135. ### Coding & GitHub
  136. - **github-workflows** / **github-auth** / **github-issues** / **github-pr-workflow** / **github-code-review** / **github-pre-push-gates** / **github-readme-maintenance** / **github-repo-management** — the full GitHub lifecycle
  137. - **codebase-inspection** — inspect repos with pygount
  138. - **local-app-github-publishing** — publish local apps safely
  139. - **subagent-driven-development** — delegate coding to sub-agents
  140. - **coding-worktree-recovery** — recover interrupted/overlapping agent work
  141. - **specification-compliance-review** / **application-security-review** — audit implementations and security
  142. - **stale-patch-reconciliation** — rebase stale patches onto a moved checkout
  143. - **cross-browser-typography-qa** / **inspecting-hermes-desktop-dom** — web/desktop debugging
  144. - **hermes-agent-skill-authoring** — write new skills
  145. - **opencode** — delegate coding to the OpenCode CLI
  146. - **dogfood** — exploratory QA of web apps
  147. ### Computer use & macOS
  148. - **computer-use** — drive the desktop GUI in the background
  149. - **macos-app-automation** — AppleScript, URL schemes, System Events
  150. - **macos-storage-management** — free space, move files to SSDs
  151. - **apple-reminders** — Apple Reminders
  152. - **imessage** — send/receive iMessage/SMS
  153. - **notes-automation-workflows** — bulk Apple Notes automation
  154. ### Creative & community
  155. - **content-style** — write for r/hermesagent and similar communities
  156. - **claude-design** — one-off HTML artifacts (landing pages, decks, prototypes)
  157. - **marketing-collateral-design** — design/critique/export collateral
  158. ### Social
  159. - **reddit-browse-and-post** — browse, read, and post to Reddit
  160. - **xurl** — X/Twitter
  161. - **meta-business-posting** — publish to a Facebook Page
  162. - **publication-link-audit** — verify every outbound link before publishing
  163. ### Health & personal
  164. - **meal-tracker** — log meals and calories from a photo or description
  165. ### Competitive analysis
  166. - **product-competitor-analysis** — codebase-grounded competitor assessments
  167. > Note: `hermes update` adds the standard library (docx, xlsx, pdf, email, plan,
  168. > and more) on top of these. The full inventory any time:
  169. > `hermes --profile donna skills list`
  170. ## Notes
  171. - **Memory starts empty and generic.** Donna ships with neutral style and
  172. operating-practice seeds in `memories/` (no personal data) and builds a
  173. profile-scoped Mnemosyne store as you work.
  174. - **Credentials live in `.env`.** Copy `.env.example` to `.env` and fill in the
  175. keys you need. Never commit it — `.gitignore` already excludes it.
  176. - **Approvals & autonomy.** Donna is written to act, not pester — she executes
  177. routine, reversible, in-scope work without asking and only pauses for
  178. destructive, external, payment, or credential actions (see `SOUL.md`, which
  179. loads in every session; `AGENTS.md` loads only from the profile directory). Separately, Hermes's own tool-approval prompts ship as
  180. `approvals.mode: manual` in `config.yaml`, so the first few file writes or
  181. terminal commands may ask for a y/n. If you want her to run those without
  182. asking, set `hermes --profile donna config set approvals.mode auto` — that's a
  183. trust setting you choose, not one we ship.
  184. - **Provider.** The default model provider is `deepseek` — direct calls only. (The
  185. optional Token Router classifier is a separate, opt-in place where OpenRouter is
  186. a natural fit; see that section.)
  187. ## License & credits
  188. - Profile: MIT — see `LICENSE`.
  189. - The Donna persona is an original assistant archetype *inspired by* the character
  190. Donna Paulsen from *Suits* (operating style only — no dialogue, catchphrases, or
  191. copyrighted material is reproduced).
  192. - The profile avatar was generated for this project; swap in your own if you prefer.
  193. - Skills and tooling were battle-tested by the r/hermesagent community.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.