# Agent Format

> Standard formatting for agent messages. Visual hierarchy, status indicators, progress bars — scannable on Telegram, Discord, Slack, WhatsApp. The baseline for readable agent output.

- Skill: `modbender/agent-format` (Agent Skill)
- Install (CLI): `npx skillmds@latest add modbender/agent-format`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/agent-format/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/agent-format

---


# Agent Format

How agents should format messages for chat apps.

## Patterns

### Status Indicators

| Symbol | Meaning |
|--------|---------|
| 🟢 | Good / Done |
| 🟡 | In Progress / Warning |
| 🔴 | Blocked / Error |
| 🔥 | Urgent |
| ⚡ | Quick |

### Progress Bars

```
████████░░ 80%
██████░░░░ 60%
████░░░░░░ 40%
```

**Chars:** `█` (filled) `░` (empty)

### Sparklines

```
▁▂▃▅▇█▇▅▃▂
```

**Chars (low→high):** `▁ ▂ ▃ ▄ ▅ ▆ ▇ █`

### Tables (Monospace)

```
Project     Status    Owner
─────────────────────────────
Alpha       🟢 Done   PM
Beta        🟡 WIP    CTO
Gamma       🔴 Block  Sales
```

## Principles

**Lead with signal.** Most important first.

**Assume scanning.** Nobody reads walls of text.

**Visual hierarchy.** Emoji → bars → text.

## Example

```
📊 Status

🔴 Blocked
• Client scope (waiting)

🟡 Active
• Launch prep ████████░░ 80%

🟢 Done
• Demo ✓
• Docs ✓

📈 Week: ▂▃▅▆▇█
```

## Reference

```
Progress: ░█
Spark:    ▁▂▃▄▅▆▇█
Divider:  ─────
Status:   🟢🟡🔴🔥⚡
```