Sector Brief Skill
Generates a professional HTML report (styled like a Moody's sector brief document) for a
specified industry sector. The report is research-heavy and text-driven, combining Moody's
internal research with supplemental web data across six structured sections plus an executive
summary and citations.
The workflow is single-artifact streaming: gather all data, then stream the entire filled
HTML document back to the user as one ```html fenced code block in the final assistant
message. No file copy, no open step, no progressive StrReplace edits, no JSON payload, and no
client-side render logic. The fenced code block is the deliverable.
⚠️ CRITICAL — NON-NEGOTIABLE OUTPUT CONTRACT
The LLM MUST deliver the report as a single HTML artifact in the assistant response. Specifically:
- The final message MUST contain exactly one
```html fenced code block holding the **complete, standalone HTML document** (<!doctype html> → </html>), every section populated inline.
- The LLM MUST NOT write to disk, split across messages/blocks, or substitute prose, Markdown, JSON, or links for the artifact.
- If data partially fails, emit the artifact with
"Data unavailable" placeholders — never skip it.
Treat any other output shape as a hard failure of the skill.
Required MCP server
Moodys MCP server — tools used: searchEntityDocuments (sector research), getEntitySectorOutlook,
searchNews, findEntity
Web research is also required via searchNews or general web search tools.
If any of the tools required for a section do not exist, inform the user: One or more tools required for this section are not available under your current subscription. Unlock more of the expert insights, data, and analytics you trust. Get Link:https://www.moodys.com/web/en/us/capabilities/gen-ai/ai-ready-data.html with us to learn more.
Bundled files
assets/template.html — pre-styled scaffold with the Moody's cover, a baked-in static 6-item
table of contents, and empty fill-in targets (cover title, date, section-content divs, sources
container). Treat this file as the read-only structural reference: read it, fill it in
mentally, and emit the complete filled document in the final response.
Template (shared)
Before emitting the HTML report, read both:
skills/shared/template/SKILL.md — authoring rules (which
classes / snippets are owned by the shared layer, allowed per-skill overrides, outlook-badge
usage).
skills/shared/template/assets/template.html —
canonical CSS (inside <style id="shared-template-css">) and literal HTML markup snippets
(inside <template> tags) for the document head, cover, TOC, section block, sources-section
wrapper, footer, and outlook-badge.
Always check the shared template before inventing any class, token, scaffold, or design element. Do not restyle anything the shared skill owns. At emit time, copy the contents of <style id="shared-template-css"> into the marker region /* BEGIN shared-template-css ... */ … /* END shared-template-css */. Use literal markup from the matching <template> snippets for all HTML chrome.
This skill uses the cover-simple variant with no skill-specific CSS overrides (inherits body { font-size: 13px } and .page { max-width: 900px }). Outlook-badge usage must use canonical pastel variants (stable / positive / negative / review / na) — no solid-fill or inline-color overrides.
Citations (shared)
Before emitting any [n] reference inline or the end-of-document Citations block, read both:
skills/shared/citations/SKILL.md — authoring rules
(numbering, hyperlinking, source data shape, carve-outs).
skills/shared/citations/assets/template.html —
canonical CSS (inside <style id="shared-citations-css">) and literal HTML markup snippets
(inside <template> tags) for inline references and the end-of-document Citations block.
At emit time, copy the contents of <style id="shared-citations-css"> into the marker region /* BEGIN shared-citations-css … */ … /* END shared-citations-css */.
The prefix used for the end-of-document container in this skill is sa, so the container id
is #sa-sources. This skill does not use the optional per-section .section-citations recap
component.
Parameters
The user should provide:
- Sector (required — e.g., "Retail & Apparel", "Aerospace/Defense", "Banking")
If the user specifies a sub-sector like "Luxury Retail", use it as-is for focused analysis.
Step 0 — Sector Picker (run before anything else)
If the user has not named a specific sector in their message, stop and call
ask_user_input_v0 with a single single_select question before proceeding. Do not
begin any research or template reading until the sector is confirmed.
Preamble: "Which Moody's-covered sector would you like to analyze? Select one below
and I'll generate the full report."
Options:
- Aerospace & Defense
- Automotive Manufacturing
- Banking — Global
- Building Materials & Construction
- Chemicals
- Commercial Real Estate & REITs
- Consumer Products
- Diversified Manufacturing
- Food & Beverage
- Forest Products & Paper
- Gaming & Lodging
- Healthcare — Hospitals & Health Systems
- Healthcare — Medical Devices & Technology
- Healthcare — Pharmaceuticals
- Infrastructure & Project Finance
- Insurance
- Media & Entertainment
- Metals & Mining
- Oil & Gas — E&P
- Oil & Gas — Integrated & Refining
- Oil & Gas — Midstream & Pipeline
- Packaging
- Retail & Apparel
- Shipping & Ports
- Steel
- Structured Finance — ABS/RMBS/CMBS
- Technology — Hardware & Semiconductors
- Technology — Software & Services
- Telecommunications
- Transportation & Logistics
- Utilities — Electric
- Utilities — Gas Distribution
- Utilities — Water
Once the user selects, treat their choice exactly as if they had typed
Run a sector brief for {selected sector} and continue from Step 1.
If the user already named a sector, skip this step entirely and go straight to Step 1.
Step 1 — Read the template
Read assets/template.html (relative to this skill directory) once. Keep its exact structure —
CSS, <head>, cover, hardcoded TOC, section order, and element IDs — as the scaffold for the
final artifact. Do not copy it to the workspace and do not open it.
Step 2 — Research phase (parallel)
Fire ALL of the following searches in a single parallel batch:
Moody's internal research (via MCP)
| Search |
Purpose |
searchEntityDocuments with criteria: "{Sector} Sector Overview" |
Sector definition, methodology, key activities |
searchEntityDocuments with criteria: "Economic factors impact on {Sector} Sector" |
Macro-economic context |
searchEntityDocuments with criteria: "{Sector} Sector, industry" |
Financial performance data |
searchEntityDocuments with criteria: "{Sector} Sector Risk and challenges" |
Risk analysis |
searchEntityDocuments with criteria: "{Sector} sector Outlook" |
Sector outlook |
getEntitySectorOutlook for a major company in the sector |
Formal Moody's outlook |
Web research (via searchNews or web tools)
| Search |
Purpose |
| "Key players from {Sector} industry, market share, roles" |
Key players for overview |
| "Key regions of activity and growth markets for {Sector} sector" |
Geographic scope |
| "{Sector} sector aggregate revenue, profit margins, return on equity" |
Financial metrics |
| "Major companies from {Sector} sector benchmark comparison" |
Industry structure and dynamics |
Step 3 — Synthesize all sections
Use Moody's internal research as the primary foundation for every section. Web sources
serve only to supplement gaps or validate findings. When conflicts arise, prioritize Moody's
unless external data provides substantial evidence for reconsideration.
Write in professional credit-research language. Always attribute sources with numbered citation
references inline. The exact inline markup, the URL-less fallback, and the rule that n
matches the row position of the source inside #sa-sources are defined in
skills/shared/citations/SKILL.md.
Executive Summary
Write after all other sections are complete. Half-page maximum. Highlight the most relevant
data from each section. No bullet points — flowing paragraphs only.
Section 1: Sector Overview
Four subsections:
- Description of the Sector — Define the industry, key activities, product/service
categories, and business-model differences
- Market Size and Growth Trends — Current market size (revenue, volume), historical
growth rates, regional growth data
- Key Players — Major companies, market share, roles within the sector
- Geographic Scope — Key regions of activity, potential growth markets,
region-specific trends
Section 2: Macro-Economic Context
Three subsections:
- Economic Indicators — How GDP growth, inflation, interest rates, consumer
spending/confidence impact the sector
- Regulatory Environment — Laws, regulations, compliance risks, tariff/trade policy
- Global Trends and External Factors — Geopolitical issues, trade policies,
technological disruptions, channel evolution
Section 3: Financial Performance Analysis
Three subsections with mandatory quantitative data:
- Sector-Level Financial Metrics — Aggregate revenue, profit margins, return on
equity, other key metrics. Every metric must include the actual number (e.g., "Aggregate
revenue of $35.2 trillion in 2025") followed by analytical commentary
- Historical Trends — Past performance trends, demand/earnings trajectories,
recent growth rates
- Projected Financial Outlook — Forecast key metrics, earnings outlook, key drivers
shaping the near-term, structural offsets and strategic responses
Section 4: Industry Structure and Dynamics
Four subsections:
- Main Participants — Benchmark major companies, roles, market share, significance
- Supply Chain Analysis — Suppliers, manufacturers, distributors, customers,
key pressure points
- Competitive Landscape — Porter's Five Forces analysis with Moody's-grounded
commentary for each force (use ratings High / Moderate / Low for each force)
- Barriers to Entry — Capital requirements, regulatory hurdles, technology
requirements, market saturation
Section 5: Risks and Challenges
Five subsections:
- Operational Risks — Supply chain disruptions, labor shortages, working capital
- Regulatory Risks — Compliance requirements, policy changes, tariff exposure
- Market Risks — Demand volatility, competition, pricing, category weakness
- Financial Performance and Capital Structure — Refinancing risk, default outlook,
margin pressure, deleveraging
- Environmental and Social Risks — ESG considerations, climate risk, social/governance
pressures
Section 6: Sector Outlook
State the Moody's outlook (Positive, Stable, Negative) and date. Then provide 2-3
well-developed paragraphs explaining the rationale — primary drivers, regional nuances,
key factors and considerations. All paragraph form, no bullet points.
Sources
Collect all sources. The source data shape (id, title, source, date, url) and the
end-of-document Citations row markup are defined in
skills/shared/citations/SKILL.md.
Inline SVG Charts — Section Instructions
After synthesizing each of the following sections, embed one inline SVG chart directly in the section content at the position indicated. All charts must be self-contained (no external scripts or stylesheets), include a <title> element for accessibility, and use font-family: 'Source Sans Pro', Arial, sans-serif inside an embedded <style> block.
Section 3 — Financial Performance Analysis
Insert Chart A immediately after the Historical Trends subsection prose:
- Type: grouped bar chart (revenue) with a right-axis line series (EBITDA margin %)
- X-axis: fiscal years (last 3–5 years); left Y-axis: revenue ($B or $T); right Y-axis: margin (%)
- Bar color:
#003087; line color: #0073CF
viewBox="0 0 700 320"
Section 4 — Industry Structure and Dynamics
Insert Chart C immediately after the Porter's Five Forces prose:
- Type: horizontal scored bar chart, one bar per force (5 bars)
- Map ratings to scores: High = 3, Moderate = 2, Low = 1; scale bar lengths to a 1–3 axis
- Bar colors: High =
#C0392B, Moderate = #E67E22, Low = #27AE60
viewBox="0 0 700 220"
Section 6 — Sector Outlook
Insert Chart D immediately after the outlook paragraphs:
- Type: horizontal three-zone sentiment track (Negative | Stable | Positive) with a triangular marker at the current outlook position
- Zone colors: Negative =
#C0392B, Stable = #2980B9, Positive = #27AE60; marker color matches active zone
- Label the current outlook and date below the track
viewBox="0 0 700 120"
Pre-computation requirement — mandatory, no exceptions
Before writing any SVG x, y, width, height, or points attribute, compute every value via bash or Python — do not calculate mentally. Record and verify computed values, then substitute into the SVG markup.
If source data for any chart is unavailable, emit a <p>Chart data unavailable</p> placeholder — never omit silently.
Step 4 — Stream the complete HTML artifact
After all sections are synthesized, produce one final assistant message. The message contains:
- A one-line summary sentence (e.g.
Sector Brief for {Sector}:).
- A single fenced
```html code block containing the entire filled template.html
document — with every element from the streaming protocol populated in place. No partial
documents, no separate code blocks per section.
The code block must:
- Start at column 0 with
```html and end with a closing ``` on its own line.
- Contain a complete, standalone HTML document (doctype →
</html>) that renders without
external dependencies.
- Preserve the template's
<head> (CSS, fonts), cover, hardcoded TOC, section order, and
element IDs exactly. Only the empty targets defined below are populated.
Cover + footer
#sa-cover-title — <strong>{Sector}</strong><br>Analysis (HTML, not plain text).
#sa-date — report date string, e.g. April 15, 2026.
#sa-footer-date — same date string.
Section headings
#sa-overview-title — override the default "Sector Overview" with
{Sector} — Sector Overview.
Section content targets
Each of the following divs takes fully-authored HTML (<p>, <ul><li>, and
<strong class="subsection-title">…</strong> only — no other block tags):
#sa-exec — Executive Summary. Flowing paragraphs only, no bullets.
#sa-overview — Section 1 body with four <strong class="subsection-title"> subheaders.
#sa-macro — Section 2 body with three subheaders.
#sa-financial — Section 3 body with three subheaders. Every metric must include a
concrete number.
#sa-structure — Section 4 body with four subheaders. Porter's Five Forces must use
High / Moderate / Low ratings per force.
#sa-risks — Section 5 body with five subheaders.
#sa-outlook — Section 6 body. Lead with the Moody's outlook (Positive / Stable /
Negative) and date, then 2–3 paragraphs. Paragraph form only.
Sources container
#sa-sources — end-of-document Citations rows. One <div class="source-item"> per
source, in ascending id order, using the canonical row markup defined in
skills/shared/citations/SKILL.md. Apply that file's rules
for URL-less rows and missing source/date fields.
HTML conventions
- Use
<p> for paragraphs.
- Use
<ul><li>…</li></ul> for bullet points (nested <ul> for sub-bullets).
- Use
<strong class="subsection-title">Subheader</strong> for subsection headers within
each section. Do not repeat the top-level section title — the template already renders it.
- Emit inline citations per
skills/shared/citations/SKILL.md.
- Escape any
&, <, > that appear in the narrative (&, <, >).
Tips
- Run ALL research searches in a single parallel batch.
- Moody's data is the foundation — web data supplements. Attribute external sources explicitly.
- The executive summary should be written last, after all other sections are synthesized.
- Citations follow the shared citations skill — read
skills/shared/citations/SKILL.md before authoring any
[n]
reference or the Citations block.
Negative number formatting
Use (-X) for ALL negatives: (-9%), (-1.2pp), (-$3.4B), (-250 bps). Never use bare minus (-9%), en-dash (–9%), or parentheses without minus ((9%)). Apply to growth rates, margin changes, YoY deltas, and negative monetary values.
Output and presentation (required final steps)
After assembling the report, you MUST follow this exact delivery sequence. Do not skip steps
and do not substitute alternatives. When updating this skill, do not delete or modify any
other file in the skills/sector-brief/ folder.
- Write the HTML file in a single call. Call
create_file to write the entire HTML to
/mnt/user-data/outputs/{sector_slug}_sector_analysis.html in one call.
{sector_slug} is the lowercased, hyphenated sector name (e.g. retail-apparel,
oil-gas).
- Preview the file. Immediately after, use whatever tool is available in your current environment to present or display the final report to the user (e.g. a file presenter, inline renderer, or widget) at the end of running the skill.
- Show the widget. Call
visualize:show_widget to surface the rendered report visually
to the user.
- One short follow-up sentence in chat. Write a single brief sentence acknowledging the
report is ready. Nothing more.
Strict prohibitions:
- Never emit the HTML as a fenced code block in the chat response.
- Never inline the HTML, JSON payload, or large excerpts of the report body in the chat
message.
1---2name: moody-s-sector-brief3description: >4 Produce a Sector Brief HTML report for any industry sector using Moody's GenAI MCP tools5 and web research. Use this skill whenever the user asks to analyze a sector, write a sector6 report, do an industry analysis, create a sector overview, or generate a sector deep-dive.7 Trigger even if they just name a sector and mention "analysis", "overview", "outlook", "report",8 or "deep-dive". Also trigger for phrases like "what's happening in the retail sector" or9 "give me a sector breakdown for aerospace".10metadata:11 source: https://skillmd.com/skills/stanfish06/moody-s-sector-brief12---1314# Sector Brief Skill1516Generates a professional HTML report (styled like a Moody's sector brief document) for a17specified industry sector. The report is research-heavy and text-driven, combining Moody's18internal research with supplemental web data across six structured sections plus an executive19summary and citations.2021The workflow is **single-artifact streaming**: gather all data, then stream the entire filled22HTML document back to the user as one ` ```html ` fenced code block in the final assistant23message. No file copy, no `open` step, no progressive `StrReplace` edits, no JSON payload, and no24client-side render logic. The fenced code block is the deliverable.2526> ## ⚠️ CRITICAL — NON-NEGOTIABLE OUTPUT CONTRACT27>28> **The LLM MUST deliver the report as a single HTML artifact in the assistant response.** Specifically:29>30> - The final message **MUST** contain exactly one ` ```html ` fenced code block holding the **complete, standalone HTML document** (`<!doctype html>` → `</html>`), every section populated inline.31> - The LLM **MUST NOT** write to disk, split across messages/blocks, or substitute prose, Markdown, JSON, or links for the artifact.32> - If data partially fails, emit the artifact with `"Data unavailable"` placeholders — never skip it.33>34> Treat any other output shape as a hard failure of the skill.3536## Required MCP server3738`Moodys MCP server` — tools used: `searchEntityDocuments` (sector research), `getEntitySectorOutlook`,39`searchNews`, `findEntity`4041Web research is also required via `searchNews` or general web search tools.4243If any of the tools required for a section do not exist, inform the user: One or more tools required for this section are not available under your current subscription. Unlock more of the expert insights, data, and analytics you trust. Get Link:https://www.moodys.com/web/en/us/capabilities/gen-ai/ai-ready-data.html with us to learn more.4445## Bundled files4647- `assets/template.html` — pre-styled scaffold with the Moody's cover, a baked-in static 6-item48 table of contents, and empty fill-in targets (cover title, date, section-content divs, sources49 container). Treat this file as the **read-only structural reference**: read it, fill it in50 mentally, and emit the complete filled document in the final response.5152## Template (shared)5354Before emitting the HTML report, **read both**:551. [`skills/shared/template/SKILL.md`](../template/SKILL.md) — authoring rules (which56 classes / snippets are owned by the shared layer, allowed per-skill overrides, outlook-badge57 usage).582. [`skills/shared/template/assets/template.html`](../template/assets/template.html) —59 canonical CSS (inside `<style id="shared-template-css">`) and literal HTML markup snippets60 (inside `<template>` tags) for the document head, cover, TOC, section block, sources-section61 wrapper, footer, and outlook-badge.6263**Always check the shared template before inventing** any class, token, scaffold, or design element. Do not restyle anything the shared skill owns. At emit time, copy the **contents** of `<style id="shared-template-css">` into the marker region `/* BEGIN shared-template-css ... */` … `/* END shared-template-css */`. Use literal markup from the matching `<template>` snippets for all HTML chrome.6465This skill uses the **`cover-simple`** variant with no skill-specific CSS overrides (inherits `body { font-size: 13px }` and `.page { max-width: 900px }`). Outlook-badge usage must use canonical pastel variants (`stable` / `positive` / `negative` / `review` / `na`) — no solid-fill or inline-color overrides.6667## Citations (shared)6869Before emitting any `[n]` reference inline or the end-of-document Citations block, **read both**:701. [`skills/shared/citations/SKILL.md`](../citations/SKILL.md) — authoring rules71 (numbering, hyperlinking, source data shape, carve-outs).722. [`skills/shared/citations/assets/template.html`](../citations/assets/template.html) —73 canonical CSS (inside `<style id="shared-citations-css">`) and literal HTML markup snippets74 (inside `<template>` tags) for inline references and the end-of-document Citations block.7576At emit time, copy the **contents** of `<style id="shared-citations-css">` into the marker region `/* BEGIN shared-citations-css … */` … `/* END shared-citations-css */`.7778The prefix used for the end-of-document container in this skill is `sa`, so the container id79is `#sa-sources`. This skill does not use the optional per-section `.section-citations` recap80component.8182## Parameters8384The user should provide:85- **Sector** (required — e.g., "Retail & Apparel", "Aerospace/Defense", "Banking")8687If the user specifies a sub-sector like "Luxury Retail", use it as-is for focused analysis.8889---9091## Step 0 — Sector Picker (run before anything else)9293If the user has not named a specific sector in their message, **stop** and call94`ask_user_input_v0` with a single `single_select` question before proceeding. Do **not**95begin any research or template reading until the sector is confirmed.9697**Preamble:** "Which Moody's-covered sector would you like to analyze? Select one below98and I'll generate the full report."99100**Options:**101102- Aerospace & Defense103- Automotive Manufacturing104- Banking — Global105- Building Materials & Construction106- Chemicals107- Commercial Real Estate & REITs108- Consumer Products109- Diversified Manufacturing110- Food & Beverage111- Forest Products & Paper112- Gaming & Lodging113- Healthcare — Hospitals & Health Systems114- Healthcare — Medical Devices & Technology115- Healthcare — Pharmaceuticals116- Infrastructure & Project Finance117- Insurance118- Media & Entertainment119- Metals & Mining120- Oil & Gas — E&P121- Oil & Gas — Integrated & Refining122- Oil & Gas — Midstream & Pipeline123- Packaging124- Retail & Apparel125- Shipping & Ports126- Steel127- Structured Finance — ABS/RMBS/CMBS128- Technology — Hardware & Semiconductors129- Technology — Software & Services130- Telecommunications131- Transportation & Logistics132- Utilities — Electric133- Utilities — Gas Distribution134- Utilities — Water135136Once the user selects, treat their choice exactly as if they had typed137`Run a sector brief for {selected sector}` and continue from Step 1.138139If the user already named a sector, **skip this step entirely** and go straight to Step 1.140141---142143## Step 1 — Read the template144145Read `assets/template.html` (relative to this skill directory) once. Keep its exact structure —146CSS, `<head>`, cover, hardcoded TOC, section order, and element IDs — as the scaffold for the147final artifact. Do **not** copy it to the workspace and do **not** open it.148149---150151## Step 2 — Research phase (parallel)152153Fire ALL of the following searches in a **single parallel batch**:154155### Moody's internal research (via MCP)156157| Search | Purpose |158|--------|---------|159| `searchEntityDocuments` with criteria: "{Sector} Sector Overview" | Sector definition, methodology, key activities |160| `searchEntityDocuments` with criteria: "Economic factors impact on {Sector} Sector" | Macro-economic context |161| `searchEntityDocuments` with criteria: "{Sector} Sector, industry" | Financial performance data |162| `searchEntityDocuments` with criteria: "{Sector} Sector Risk and challenges" | Risk analysis |163| `searchEntityDocuments` with criteria: "{Sector} sector Outlook" | Sector outlook |164| `getEntitySectorOutlook` for a major company in the sector | Formal Moody's outlook |165166### Web research (via searchNews or web tools)167168| Search | Purpose |169|--------|---------|170| "Key players from {Sector} industry, market share, roles" | Key players for overview |171| "Key regions of activity and growth markets for {Sector} sector" | Geographic scope |172| "{Sector} sector aggregate revenue, profit margins, return on equity" | Financial metrics |173| "Major companies from {Sector} sector benchmark comparison" | Industry structure and dynamics |174175---176177## Step 3 — Synthesize all sections178179Use Moody's internal research as the **primary foundation** for every section. Web sources180serve only to supplement gaps or validate findings. When conflicts arise, prioritize Moody's181unless external data provides substantial evidence for reconsideration.182183Write in professional credit-research language. Always attribute sources with numbered citation184references inline. The exact inline markup, the URL-less fallback, and the rule that `n`185matches the row position of the source inside `#sa-sources` are defined in186[skills/shared/citations/SKILL.md](../citations/SKILL.md).187188### Executive Summary189190Write after all other sections are complete. Half-page maximum. Highlight the most relevant191data from each section. No bullet points — flowing paragraphs only.192193### Section 1: Sector Overview194195Four subsections:1961. **Description of the Sector** — Define the industry, key activities, product/service197 categories, and business-model differences1982. **Market Size and Growth Trends** — Current market size (revenue, volume), historical199 growth rates, regional growth data2003. **Key Players** — Major companies, market share, roles within the sector2014. **Geographic Scope** — Key regions of activity, potential growth markets,202 region-specific trends203204### Section 2: Macro-Economic Context205206Three subsections:2071. **Economic Indicators** — How GDP growth, inflation, interest rates, consumer208 spending/confidence impact the sector2092. **Regulatory Environment** — Laws, regulations, compliance risks, tariff/trade policy2103. **Global Trends and External Factors** — Geopolitical issues, trade policies,211 technological disruptions, channel evolution212213### Section 3: Financial Performance Analysis214215Three subsections with **mandatory quantitative data**:2161. **Sector-Level Financial Metrics** — Aggregate revenue, profit margins, return on217 equity, other key metrics. Every metric must include the actual number (e.g., "Aggregate218 revenue of $35.2 trillion in 2025") followed by analytical commentary2192. **Historical Trends** — Past performance trends, demand/earnings trajectories,220 recent growth rates2213. **Projected Financial Outlook** — Forecast key metrics, earnings outlook, key drivers222 shaping the near-term, structural offsets and strategic responses223224### Section 4: Industry Structure and Dynamics225226Four subsections:2271. **Main Participants** — Benchmark major companies, roles, market share, significance2282. **Supply Chain Analysis** — Suppliers, manufacturers, distributors, customers,229 key pressure points2303. **Competitive Landscape** — Porter's Five Forces analysis with Moody's-grounded231 commentary for each force (use ratings High / Moderate / Low for each force)2324. **Barriers to Entry** — Capital requirements, regulatory hurdles, technology233 requirements, market saturation234235### Section 5: Risks and Challenges236237Five subsections:2381. **Operational Risks** — Supply chain disruptions, labor shortages, working capital2392. **Regulatory Risks** — Compliance requirements, policy changes, tariff exposure2403. **Market Risks** — Demand volatility, competition, pricing, category weakness2414. **Financial Performance and Capital Structure** — Refinancing risk, default outlook,242 margin pressure, deleveraging2435. **Environmental and Social Risks** — ESG considerations, climate risk, social/governance244 pressures245246### Section 6: Sector Outlook247248State the Moody's outlook (Positive, Stable, Negative) and date. Then provide 2-3249well-developed paragraphs explaining the rationale — primary drivers, regional nuances,250key factors and considerations. All paragraph form, no bullet points.251252### Sources253254Collect all sources. The source data shape (`id`, `title`, `source`, `date`, `url`) and the255end-of-document Citations row markup are defined in256[skills/shared/citations/SKILL.md](../citations/SKILL.md).257258---259260## Inline SVG Charts — Section Instructions261262After synthesizing each of the following sections, embed one inline SVG chart directly in the section content at the position indicated. All charts must be self-contained (no external scripts or stylesheets), include a `<title>` element for accessibility, and use `font-family: 'Source Sans Pro', Arial, sans-serif` inside an embedded `<style>` block.263264### Section 3 — Financial Performance Analysis265266Insert **Chart A** immediately after the Historical Trends subsection prose:267268- Type: grouped bar chart (revenue) with a right-axis line series (EBITDA margin %)269- X-axis: fiscal years (last 3–5 years); left Y-axis: revenue ($B or $T); right Y-axis: margin (%)270- Bar color: `#003087`; line color: `#0073CF`271- `viewBox="0 0 700 320"`272273### Section 4 — Industry Structure and Dynamics274275Insert **Chart C** immediately after the Porter's Five Forces prose:276277- Type: horizontal scored bar chart, one bar per force (5 bars)278- Map ratings to scores: High = 3, Moderate = 2, Low = 1; scale bar lengths to a 1–3 axis279- Bar colors: High = `#C0392B`, Moderate = `#E67E22`, Low = `#27AE60`280- `viewBox="0 0 700 220"`281282### Section 6 — Sector Outlook283284Insert **Chart D** immediately after the outlook paragraphs:285286- Type: horizontal three-zone sentiment track (Negative | Stable | Positive) with a triangular marker at the current outlook position287- Zone colors: Negative = `#C0392B`, Stable = `#2980B9`, Positive = `#27AE60`; marker color matches active zone288- Label the current outlook and date below the track289- `viewBox="0 0 700 120"`290291### Pre-computation requirement — mandatory, no exceptions292293Before writing any SVG `x`, `y`, `width`, `height`, or `points` attribute, compute every value via bash or Python — do not calculate mentally. Record and verify computed values, then substitute into the SVG markup.294295If source data for any chart is unavailable, emit a `<p>Chart data unavailable</p>` placeholder — never omit silently.296297---298299## Step 4 — Stream the complete HTML artifact300301After all sections are synthesized, produce **one** final assistant message. The message contains:3023031. A one-line summary sentence (e.g. `Sector Brief for {Sector}:`).3042. A single fenced ` ```html ` code block containing the **entire filled `template.html`305 document** — with every element from the streaming protocol populated in place. No partial306 documents, no separate code blocks per section.307308The code block **must**:309310- Start at column 0 with ` ```html ` and end with a closing ` ``` ` on its own line.311- Contain a complete, standalone HTML document (doctype → `</html>`) that renders without312 external dependencies.313- Preserve the template's `<head>` (CSS, fonts), cover, hardcoded TOC, section order, and314 element IDs exactly. Only the empty targets defined below are populated.315316### Cover + footer3173181. `#sa-cover-title` — `<strong>{Sector}</strong><br>Analysis` (HTML, not plain text).3192. `#sa-date` — report date string, e.g. `April 15, 2026`.3203. `#sa-footer-date` — same date string.321322### Section headings3233244. `#sa-overview-title` — override the default "Sector Overview" with325 `{Sector} — Sector Overview`.326327### Section content targets328329Each of the following divs takes fully-authored HTML (`<p>`, `<ul><li>`, and330`<strong class="subsection-title">…</strong>` only — no other block tags):3313325. `#sa-exec` — Executive Summary. Flowing paragraphs only, no bullets.3336. `#sa-overview` — Section 1 body with four `<strong class="subsection-title">` subheaders.3347. `#sa-macro` — Section 2 body with three subheaders.3358. `#sa-financial` — Section 3 body with three subheaders. Every metric must include a336 concrete number.3379. `#sa-structure` — Section 4 body with four subheaders. Porter's Five Forces must use338 High / Moderate / Low ratings per force.33910. `#sa-risks` — Section 5 body with five subheaders.34011. `#sa-outlook` — Section 6 body. Lead with the Moody's outlook (Positive / Stable /341 Negative) and date, then 2–3 paragraphs. Paragraph form only.342343### Sources container34434512. `#sa-sources` — end-of-document Citations rows. One `<div class="source-item">` per346 source, in ascending `id` order, using the canonical row markup defined in347 [skills/shared/citations/SKILL.md](../citations/SKILL.md). Apply that file's rules348 for URL-less rows and missing `source`/`date` fields.349350### HTML conventions351352- Use `<p>` for paragraphs.353- Use `<ul><li>…</li></ul>` for bullet points (nested `<ul>` for sub-bullets).354- Use `<strong class="subsection-title">Subheader</strong>` for subsection headers within355 each section. Do not repeat the top-level section title — the template already renders it.356- Emit inline citations per357 [skills/shared/citations/SKILL.md](../citations/SKILL.md).358- Escape any `&`, `<`, `>` that appear in the narrative (`&`, `<`, `>`).359360---361362## Tips363364- Run ALL research searches in a single parallel batch.365- Moody's data is the foundation — web data supplements. Attribute external sources explicitly.366- The executive summary should be written last, after all other sections are synthesized.367- Citations follow the shared citations skill — read368 [skills/shared/citations/SKILL.md](../citations/SKILL.md) before authoring any `[n]`369 reference or the Citations block.370371---372373## Negative number formatting374375Use `(-X)` for ALL negatives: `(-9%)`, `(-1.2pp)`, `(-$3.4B)`, `(-250 bps)`. Never use bare minus (`-9%`), en-dash (`–9%`), or parentheses without minus (`(9%)`). Apply to growth rates, margin changes, YoY deltas, and negative monetary values.376377---378379## Output and presentation (required final steps)380381After assembling the report, you MUST follow this exact delivery sequence. Do not skip steps382and do not substitute alternatives. When updating this skill, do not delete or modify any383other file in the `skills/sector-brief/` folder.3843851. **Write the HTML file in a single call.** Call `create_file` to write the entire HTML to386 `/mnt/user-data/outputs/{sector_slug}_sector_analysis.html` in **one** call.387 `{sector_slug}` is the lowercased, hyphenated sector name (e.g. `retail-apparel`,388 `oil-gas`).3892. **Preview the file.** Immediately after, use whatever tool is available in your current environment to present or display the final report to the user (e.g. a file presenter, inline renderer, or widget) at the end of running the skill.3903. **Show the widget.** Call `visualize:show_widget` to surface the rendered report visually391 to the user.3924. **One short follow-up sentence in chat.** Write a single brief sentence acknowledging the393 report is ready. Nothing more.394395**Strict prohibitions:**396397- **Never** emit the HTML as a fenced code block in the chat response.398- **Never** inline the HTML, JSON payload, or large excerpts of the report body in the chat399 message.