by-display

BY Display Patterns

Standard display formats for all campaign output. They use Unicode box-drawing characters and markdown that render natively in Claude Code's terminal. Never use ANSI escape codes in response text — they render as literal characters.

Every other BY skill (research, screening, scoring, campaign-manager, ...) calls into these templates when it is time to talk to the user. This file is the canonical source; the literal templates live in references/output-format-spec.md so other skills can copy them verbatim.

---

When to Use This Skill

Use this skill when you are:

• ✅ Rendering campaign status for /by:status, /by:watch, or phase transitions
• ✅ Formatting screening reports (liabilities, developability, structure scores)
• ✅ Showing ranked results for /by:results or any final campaign output
• ✅ Displaying errors or quota warnings that need user attention
• ✅ Presenting a checkpoint or safety gate that requires explicit user approval
• ✅ Streaming progress during long-running design/fold jobs
• ✅ Closing a phase — every major phase ends with a "Next Up" block

Do NOT use this skill when:

• ❌ You need to compute scores — that is by-scoring; this skill only renders them
• ❌ You need to run a screening battery — that is by-screening
• ❌ You need to decide what to do next — that is by-campaign-manager / by-design-workflow
• ❌ You need raw machine-readable JSON output for another tool — emit JSON directly, not the human-facing templates here
• ❌ You want to invent a new visual style — extend the templates here instead of forking them

---

Inputs

This skill is consumed by other skills. Inputs are the data objects to be rendered:

Required (one of):

• Campaign checkpoint object — { campaign_id, target, phases: [{name, status, time, details}, ...], current_phase }. Source: by-campaign-manager (campaign_state.json).
• Ranked design list — [{ design_id, composite, ipSAE, ipTM, pLDDT, liabilities, verdict }, ...]. Source: by-scoring / by-screening.
• Screening report object — { design_id, liabilities: {...}, developability: {...}, structure: {...}, verdict }. Source: by-screening.
• Progress event — { phase, status (◆/✓/✗), message, elapsed }. Source: any long-running skill.
• Error object — { title, details, suggested_next }.