# 414 Agent Calibration A87c080f

> Agent Calibration Reference

- Skill: `tools-only/414-agent-calibration-a87c080f` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/414-agent-calibration-a87c080f`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/414-agent-calibration-a87c080f/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/414-agent-calibration-a87c080f

---

# Agent Calibration Reference

Prime agents with a boot message on creation, and recalibrate after updates.

## First Message

The `first_message` field sends a message to the agent on first creation only (never on updates). Used to make agents internalize their role.

```yaml
agents:
  - name: support-agent
    first_message: "Review your persona block and confirm you understand your role."
```

The message is sent asynchronously after creation.

## Recalibration

After updating agent config, recalibrate to re-prime agents:

```bash
# Recalibrate all changed agents
lettactl apply -f fleet.yaml --recalibrate

# Custom message
lettactl apply -f fleet.yaml --recalibrate --recalibrate-message "Review updated guidelines."

# Scope by tags
lettactl apply -f fleet.yaml --recalibrate --recalibrate-tags "role:support"

# Scope by pattern
lettactl apply -f fleet.yaml --recalibrate --recalibrate-match "support-*"

# Fire-and-forget
lettactl apply -f fleet.yaml --recalibrate --no-wait
```

## SDK

```typescript
await ctl.bulkSendMessage('Review your updated configuration.', {
  pattern: 'support-*',
});
```

## Options

| Flag | Description |
|------|-------------|
| `--skip-first-message` | Skip first_message on creation |
| `--recalibrate` | Re-send calibration messages |
| `--recalibrate-message <msg>` | Custom calibration message |
| `--recalibrate-tags <tags>` | Scope by tags (AND logic) |
| `--recalibrate-match <pattern>` | Scope by glob pattern |
| `--no-wait` | Fire-and-forget |

## Retraining vs Recalibration

- **Recalibrate**: Send a message in-place, preserves conversation history
- **Retrain**: Delete and redeploy for a fresh start (`lettactl delete agent <name>` then `lettactl apply`)