Briefing formatting guidelines for chat messages
Scanned 9/3/2026
Install to Claude Code
npx -y skills add istota-project/istota --skill briefing --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Briefing?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/istota-project-briefing)More formats (shields.io, HTML) on the badges page.
---
name: briefing
description: Briefing formatting guidelines for chat messages
exclude_memory: true
exclude_persona: true
source_types: [briefing]
exclude_skills: [email]
---
Briefings must be returned as a JSON object: `{"body": "<content>"}`. The body contains the full briefing text, one section per block, using `\n` for newlines. Do not output anything outside the JSON object. Do not write a title or subject line for the briefing as a whole — the delivery layer supplies it. Do not send emails or use email commands — delivery is handled by the scheduler.
The body is formatted for chat messages (markdown). Title each section with its block's title exactly as given — the title may already include an emoji, in which case keep it; if it doesn't, do not add one. Only include sections that have data.
## Structure — follow the prompt
The prompt presents the briefing's content grouped into **blocks**, each with a title and its gathered source data (tagged by provenance). Produce **one section per block**, titled with the block's title verbatim (emoji only if the title itself carries one — never invent one), in the exact order the blocks appear. Honor any per-block synthesis directive (story counts, tone, "include verbatim"). Omit a block that has no content — never emit an empty header. Do not reorder sections to match the order data happened to arrive within a block.
A block may fan in several sources of different kinds (newsletters, RSS entries, a browsed frontpage, structured market/calendar data). **Synthesize them into one coherent section**: merge stories that recur across sources into a single entry with combined attribution, rather than stacking each source as its own sub-list. A source marked as pre-formatted / "include as-is" (market quotes, calendar events, a pre-selected reminder) must be reproduced verbatim — do not reword its numbers, quotes, or details.
## Allowed Markdown
- **bold** for emphasis
- *italic* for secondary emphasis
- [links](url) for URLs
- --- horizontal rule before a reminder section
- Bullet points for lists
## Forbidden
- Tables
- Markdown headings (#, ##, etc.)
- Code blocks (unless showing actual code)
- Nested bullet points
- Commentary or editorializing on market data
## Section formatting reference
Apply the formatting below by content type — a block's title names the section; its sources' content determines which of these patterns fits.
**News** (newsletters + frontpages)
General news — politics, world events, policy, science, tech (non-market). Keep a global perspective. Lead with items that recur across multiple sources. One short paragraph per story (two or three sentences), bold uppercase topic, source attribution in brackets at the end. Place a story by topic — tariff *policy* is news, its *market impact* is a markets item.
Link each source in the attribution to the specific article it came from **when the prompt gives that source an article URL**. Two shapes carry one: an RSS/feed item ends in `[article: <url>]`, and a newsletter body has its links inline as markdown `[text](url)`. Make the source name a markdown link to that URL; keep the surrounding brackets. In a newsletter, use the link on the story you're summarizing — not the newsletter's home page, web-version, or "read more from us" link; if a story has no link of its own, leave that source plain. Use a plain-text source name when no URL is available (browsed frontpages have none). Never invent, guess, or reuse a URL for a source that didn't provide one — a plain `[Source]` is correct there.
<news_example>
**IRAN-US TENSIONS ESCALATE:** Iran's foreign minister warned that Tehran's forces have their "fingers on the trigger" as Trump threatened a "massive Armada" heading toward Iran. The EU is expected to add Iran's Revolutionary Guard to its terror blacklist. [[Semafor](https://www.semafor.com/article/iran-us-tensions), NYT]
</news_example>
Here Semafor's item carried an article URL so its name links to it; NYT stays plain text because its newsletter carried no link for that story. A story appearing in both a frontpage and a newsletter is one entry with combined attribution: `[AP, Semafor]`, linking whichever sources supplied a URL.
**Markets**
One line per quote with a 🟢/🔴/⚪ indicator based on change direction, bold the name:
🟢 **S&P 500 E-mini**: 6,104.75 (+30.25, +0.50%)
🔴 **Nasdaq 100 E-mini**: 21,857.50 (-45.00, -0.21%)
Copy the pre-fetched quote data exactly, preserving all numbers. No commentary. On weekends, quotes may be omitted. After quotes, summarize market/economic news (earnings, central-bank moves, sectors, commodities, data) — short paragraphs, bold topic, bracketed attribution. Evening briefings include pre-formatted FinViz sections (headlines, movers, futures, forex/bonds, economic data, earnings) — copy them as-is, in that order, within the markets section.
**Calendar**
Bullet list of events with times in the user's local timezone. Bold the event name.
- **10:00 Team standup** (30 min)
- **14:00 Dentist** (1 hr, Downtown Clinic)
**Todos**
Bullet list of pending items, copied verbatim.
**Notes**
Bullet list of relevant agenda items or reminders from the notes content.
**Reminder**
Copy any pre-selected reminder in the prompt verbatim — do NOT generate, paraphrase, or replace it. Use italic for emphasis; keep any attribution. Never read reminder files yourself; if no reminder is provided, omit the section.
## Source attribution
Derive source names from the provenance tags / "From:" headers: domain senders use the capitalized domain (`semafor.com` → `Semafor`), email senders a recognizable short name (`briefing@nytimes.com` → `NYT`, `markets@wsj.com` → `WSJ Markets`), frontpages the source name (`AP News` → `AP`, `Financial Times` → `FT`). Format: `[Source]` or `[Source, Source]` at the end of the paragraph.
When a story is drawn from an item that carried an article URL — `[article: <url>]` after an RSS/feed item, or an inline `[text](url)` link in a newsletter body — make that source name a markdown link to the URL: `[[Semafor](https://…)]`. For a newsletter, take the link belonging to that story; ignore its unsubscribe / web-version / social links. Link only the sources that supplied a URL — leave the rest plain text, and never fabricate a URL. Only the news section links attributions this way; markets/calendar/todos/notes/reminder attributions stay as-is.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!