mail

Locate and read emails from a local Markdown mail corpus.

3|Updated May 21, 2026
One-click install
npx skills add https://github.com/gofixpoint/amika-biz --skill mail-gofixpoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mail
Source: https://github.com/gofixpoint/amika-biz/tree/main/.agents/skills/mail
Command: npx skills add https://github.com/gofixpoint/amika-biz --skill mail-gofixpoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill explains how to work with the local mbsync-to-markdown mail corpus, including the biz mail commands (setup, mbox ls, convert, fd, rg), the per-message Markdown frontmatter, and the on-disk layout so an agent can search and read mail without re-deriving conventions.

Core Features & Use Cases

  • Understands the local mail conversion workflow and message frontmatter structure to enable AI agents to interpret mail data.
  • Documents how to configure multiple mailboxes in ~/.config/amika-biz/config.toml, how messages map to Markdown files, and how to search across the converted corpus.
  • Provides quick-start guidance for setting up, converting, and querying mail with biz mail commands.

Quick Start

Run biz mail setup to configure a mailbox, then convert mail with biz mail convert to generate Markdown messages.

Frequently Asked Questions about mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search a local mail corpus converted to markdown?

To search a local mail corpus converted to markdown, you use the `biz mail fd` and `biz mail rg` commands to query the on-disk Maildir-derived markdown files and YAML frontmatter for specific messages.

How does mbsync mail conversion to markdown work?

Mbsync mail conversion to markdown works by running `biz mail setup` to configure mailboxes in `~/.config/amika-biz/config.toml`, then using `biz mail convert` to generate markdown files with YAML frontmatter from your messages.

What is the on-disk md_box layout for stored mail messages?

The md_box layout is the on-disk directory structure for the converted mail corpus where messages are stored as individual markdown files containing YAML frontmatter, enabling AI agents to locate and read mail data natively.

Can I configure multiple mailboxes for markdown conversion and search?

Yes, you can configure multiple mailboxes for markdown conversion and search by defining them in the `~/.config/amika-biz/config.toml` configuration file before running the conversion and search commands.

Do I need YAML frontmatter in every message for AI mail search?

Yes, YAML frontmatter in every message is required because it structures the converted markdown mail data, allowing the AI agent to properly interpret, query, and cite email metadata stored in the local corpus.