agent-mail

$npx mdskill add joelhooks/joelclaw/agent-mail

Provides backward compatibility for older prompts referencing agent-mail by redirecting to the current clawmail protocol.

  • Helps bridge old instructions to the current coordination protocol seamlessly.
  • Integrates with the joelclaw mail tool for mail access and coordination tasks.
  • Decides based on explicit prompts or compatibility needs to load the canonical skill.
  • Presents results by directing users to follow the updated clawmail documentation.

SKILL.md

.github/skills/agent-mailView on GitHub ↗
---
name: agent-mail
displayName: Agent Mail (Alias)
description: >-
  Backward-compatible alias for the canonical clawmail protocol. Use when older
  prompts mention 'agent-mail'. For full, current coordination rules load the
  `clawmail` skill.
version: 1.0.0
author: joel
tags:
  - coordination
  - alias
  - protocol
---

# Agent Mail (Alias)

This skill is kept for compatibility with older prompts and habits.

**Canonical source of truth is now `skills/clawmail/SKILL.md`.**

## Use This Skill When
- a prompt explicitly asks for `agent-mail`
- you need to bridge old instructions to current protocol

## Current Rules (summary)
1. Mail access in pi goes through **`joelclaw mail`** (wrappers are fine).
2. Check inbox before starting shared work.
3. Announce scope (`Starting:`), reserve paths, send status updates, release locks.
4. Include file paths and task context in every coordination message.

## Immediate Redirect
Load and follow:
- `skills/clawmail/SKILL.md`

## Related
- ADR-0172: Agent Mail via MCP Agent Mail
- `joelclaw mail --help`

More from joelhooks/joelclaw

SkillDescription
add-skillCreate new joelclaw skills with the idiomatic process — repo-canonical, symlinked, git-tracked, slogged. Triggers on 'add a skill', 'create skill', 'new skill', 'canonical skill', 'make a skill for', or any request to formalize a process or domain into a reusable skill.
adr-skillCreate and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. Use when you need to propose, write, update, accept/reject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; or enforce ADR conventions. This skill uses Socratic questioning to capture intent before drafting, and validates output against an agent-readiness checklist.
agent-discovery"Optimize websites, docs, and product surfaces for agent discoverability and operator UX. Use when working on agent SEO/AEO/GEO, crawl policy, markdown or JSON projections, llms.txt, sitemap.md, AGENTS.md guidance, content negotiation, accessibility for browser agents, or any request to make a site easier for pi, OpenCode, Claude Code, ChatGPT, Perplexity, or other agent harnesses to find and use."
agent-loopStart, monitor, and cancel durable multi-agent coding loops via Inngest. Use when the user wants to run autonomous coding workloads, execute a PRD with multiple stories, kick off an AFK coding session, have agents implement features from a plan, or manage running loops. Triggers on "start a coding loop", "run this PRD", "implement these stories", "go AFK and code this", "check loop status", "cancel the loop", "joelclaw loop", or any request for autonomous multi-story code execution.
agent-workloads"Compatibility alias for the canonical `workflow-rig` front door. Use when older prompts mention `agent-workloads` or when you need the legacy workload-planning guidance; for new work, load `workflow-rig` first."
clawmail>-
cli-design"Design and build agent-first CLIs with HATEOAS JSON responses, context-protecting output, and self-documenting command trees. Use when creating new CLI tools, adding commands to existing CLIs (joelclaw, slog), or reviewing CLI design for agent-friendliness. Triggers on 'build a CLI', 'add a command', 'CLI design', 'agent-friendly output', or any task involving command-line tool creation."
codex-prompting"Use this skill for any request to trigger, coordinate, or craft prompts for Codex. Use when user says 'send to codex', 'use codex', 'prompt codex', 'ask codex', 'delegate to codex', 'run in codex', or asks for a Codex-first execution handoff."
content-publish"Publish content to joelclaw.com via the Convex-first pipeline. Covers the full lifecycle: draft → review → publish → revalidate → verify. Handles secret leasing, tag conventions, content types (article, tutorial, note, essay), and verification gates. Use when: 'write article about X', 'publish article <slug>', 'draft a tutorial', 'publish this', 'push to convex', or any content publishing task."
contributing-to-pi"Contribute fixes, bug reports, and upstream discussions to badlogic/pi-mono without wasting maintainer time. Use when filing pi issues, preparing pi PRs, debugging whether a bug belongs upstream, or responding to maintainer pushback. Triggers on: 'contribute to pi', 'pi-mono issue', 'upstream pi fix', 'open a pi issue', 'why did Mario reject this', or any work in ~/Code/badlogic/pi-mono meant for upstream."