integrate-agent-email SKILL.md skillB

integrate-agent-email from amd/gaia is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add amd/gaia/integrate-agent-email@git:20260926.f687b81

Pins git:20260926.f687b81 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
amd/gaia
Path
hub/agents/email/npm/SKILL.md
Versions recorded
5
Latest version
git:20260926.f687b81, committed Sep 26, 2026
First version recorded
Aug 26, 2026
Size
29,681 bytes
Repository stars
1,593
License
MIT

Use when integrating the @amd-gaia/agent-email npm package — embedding the GAIA email agent (a local triage/draft/send sidecar) into a Node, TypeScript, or Electron app. Covers install, spawning the sidecar, calling the typed client, prerequisites, and the common gotchas.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Integrating @amd-gaia/agent-email

`@amd-gaia/agent-email` embeds the GAIA email agent in a JS/TS app. It triages,
drafts, and sends email **locally on AMD Ryzen AI** — no cloud LLM. This package is
the **client**: it downloads a frozen native **sidecar** binary, spawns it, and
talks to it over local HTTP. There is **no Python** and no separate GAIA install.

Follow these steps to wire it into an app.

> **This file is NOT one of the agent's own skills.** It is the integration
> playbook — how *you* wire this npm package into an app. The sidecar separately
> bundles six **Agent Skills** at `gaia_agent_email/skills/<name>/SKILL.md`, which
> are instructions the *email agent itself* would load into its own prompt at
> runtime — currently **disabled**, so none of them loads. Same filename,
> different artifact: don't load those into your assistant, and don't ship this
> one as an agent skill. See
> [Skill sets](#skill-sets--disabled-in-this-release) below.

## 1. Install

```bash
npm install @amd-gaia/agent-email
```

The package is **ESM-only** (`"type": "module"`). Use `import`, not `require`. From
a CommonJS file, use `await import("@amd-gaia/agent-email")`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add amd/gaia/integrate-agent-email@sha256:0286018756ab1016

The line at the top of this page pins the label git:20260926.f687b81, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_yyoetorop5kbmkpb.svg)](https://markdownregistry.com/a/art_yyoetorop5kbmkpb)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 26, 2026 and Sep 26, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
git:20260926.f687b81 latest2026-09-26 f687b81 29,681 BB view · diff
git:20260926.ce0e97f2026-09-26 ce0e97f 29,608 BB view · diff
git:20260925.239a6902026-09-25 239a690 29,363 BB view · diff
git:20260910.659cb0c2026-09-10 659cb0c 29,177 BB view · diff
git:20260826.a6c68c82026-08-26 a6c68c8 28,798 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8131)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (29681 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

amd/gaia · 1,593 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yyoetorop5kbmkpb
GET https://markdownregistry.com/api/v1/resolve?ref=amd/gaia/integrate-agent-email
GET https://markdownregistry.com/api/v1/blob/0286018756ab10169fae6572bd3d74f26dc0d1b24f30603226ef4dbcc714acfc

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from amd/gaia

adding-eval-scorecard SKILL.md skill
amd/gaia · .claude/skills/adding-eval-scorecard/SKILL.md · Adopt the per-agent eval scorecard for a GAIA hub agent: write the harness→payload adapter, run the eval to produce a…
git:20261019.46c2736 · audit A · 1,593 stars
agent-hub-release SKILL.md skill
amd/gaia · .claude/skills/agent-hub-release/SKILL.md · Cut or wire the frozen-binary + npm release of an agent GAIA itself ships (the email/flagship CI pipeline: freeze ->…
git:20261019.c4b5352 · audit A · 1,593 stars
analyzing-claude-sessions SKILL.md skill
amd/gaia · .claude/skills/analyzing-claude-sessions/SKILL.md · Analyze your own local Claude Code session transcripts to find what you actually use the agent for, how effective it…
git:20260922.b869e9a · audit A · 1,593 stars
benchmarking-the-agent SKILL.md skill
amd/gaia · .claude/skills/benchmarking-the-agent/SKILL.md · Measure the flagship GAIA agent against Claude Code and across models — quality, truthfulness, steps, tokens, time and…
git:20260928.3afaf2e · audit A · 1,593 stars
driving-the-tui SKILL.md skill
amd/gaia · .claude/skills/driving-the-tui/SKILL.md · Use when testing or validating the GAIA TUI (tui/) by actually running it — driving screens, clicking and scrolling…
git:20261012.2435ea7 · audit B · 1,593 stars
gaia-build-agent SKILL.md skill
amd/gaia · .claude/skills/gaia-build-agent/SKILL.md · Build a new GAIA agent with the SDK end-to-end: scaffold the package, write the Agent subclass, register @tool…
git:20261019.46c2736 · audit A · 1,593 stars
gaia-executive-presentation SKILL.md skill
amd/gaia · .claude/skills/gaia-executive-presentation/SKILL.md · Generate an EXECUTIVE slide presentation (leadership / decision-maker audience) from a source document as…
git:20260926.670aa14 · audit A · 1,593 stars
gaia-release SKILL.md skill
amd/gaia · .claude/skills/gaia-release/SKILL.md · Cut a GAIA release end-to-end: draft notes, open release PR, run pre-tag verification, push the tag, monitor the…
git:20261019.c5cfa83 · audit A · 1,593 stars
gaia-technical-presentation SKILL.md skill
amd/gaia · .claude/skills/gaia-technical-presentation/SKILL.md · Generate a TECHNICAL slide presentation (engineering audience) from a source document as self-contained HTML that…
git:20260926.670aa14 · audit A · 1,593 stars
gaia-testing SKILL.md skill
amd/gaia · .claude/skills/gaia-testing/SKILL.md · GAIA's multi-tier regression harness — runs unit, integration, and real-world (on-machine) tiers and brings back…
git:20261016.1b15173 · audit A · 1,593 stars
gaia-tui-manual SKILL.md skill
amd/gaia · .claude/skills/gaia-tui-manual/SKILL.md · The GAIA terminal UI (gaia-tui) — how to build it, launch it with a real pty, drive it through the loopback control…
git:20261018.65415ee · audit A · 1,593 stars
github-issue-response SKILL.md skill
amd/gaia · .claude/skills/github-issue-response/SKILL.md · Respond to a GitHub issue, PR comment, discussion reply, or review on amd/gaia. Use when writing any reply that will be…
git:20261018.65415ee · audit A · 1,593 stars

Every file in amd/gaia

Browse by kind, by grade B, or by owner.