db-aeon/joshu-oss/jmail-gui

Claude Code and agent skill by db-aeon/joshu-oss

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

jMail desktop UI workflows — compose drafts, thread navigation, voice fast paths.

Install

npx vskill@latest install db-aeon/joshu-oss/jmail-gui

SKILL.md

jMail GUI skill

Use when the jMail window is open and the user is working in the desktop app (embedded chat or voice).

Platform boundary (embedded — GUI first)

When jMail is open, treat the on-screen inbox as the source of truth for read/list questions.

User intentDo thisDo NOT
List recent subjects, “what’s in my inbox”, summarize visible mailRead `inboxPreview` / `openThread` from the injected GUI snapshotComposio GMAIL_FETCH_*, joshu-mail, gbrain
Snapshot empty or user says “refresh”app_gui_action `refreshInbox` — use returned subject listComposio
Search/filter in current tabapp_gui_action `searchMail` with query, then read snapshotComposio first
Open a message / compose draftapp_gui_action `openThread` / `openCompose`Paste-only in chat
Mail outside loaded list, other account, deep archive, “search live Gmail”skill_view('joshu-mail') → gbrain → mirror → Composio—
Headless mirror/connector checksPOST /joshu/api/apps/jmail/invoke—

Never send mail — draft via openCompose only; user sends in the UI.

GUI snapshot fields

  • `activeView`: inbox_list | thread | compose | setup
  • `inboxPreview`: loaded rows in the sidebar (id, subject, from, date) — same data the user sees
  • `openThread`: full detail when a message is open

When activeView is thread, describe `openThread`, not stale compose state.

When jMail window is open (embedded chat)

  • Always call app_gui_action(appId="jmail", action=…, args=…) for in-app UI changes.
  • After drafting, always call app_gui_action with action=openCompose and { to, subject, body } — never only paste the draft in chat.

Chat-only / headless (no jMail UI)

  • Follow joshu-mail search order (gbrain → mirror → Composio live Gmail).
  • Invoke actions: connectorsStatus, syncMirror.
  • MCP send rules unchanged (Nylas agent mailbox, action guard).

Voice fast commands (manifest guiActions[].voice)

When jMail is open, voice tools are built from guiActions[].voice on the manifest (parameters inherit from the guiAction):

User saysGemini toolguiAction
"new email", "compose", "put in the draft" + bodyapp_jmail_compose({ body, subject, to })openCompose
"search mail for …"app_jmail_search({ query })searchMail
Multi-step / ambiguousthink → Hermes + app_gui_action—

Frontend tools reference

Hermes tool: `app_gui_action(appId, action, args?)`. Manifest guiActions names:

actionEffect
openComposeOpen compose pane; optional draft fields
openThreadSelect message id and load detail
searchMailSearch and refresh inbox list
startReplyReply to selected thread
switchInboxSwitch agent vs Gmail tab
refreshInboxReload list; returns subject lines for agent
syncMirrorSync local mail mirror
openSetupOpen setup pane

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/db-aeon/joshu-oss/jmail-gui/badge)](https://verified-skill.com/skills/db-aeon/joshu-oss/jmail-gui)

Something wrong with this skill or its page? Tell us.