market-briefing

name	market-briefing
description	Automate client-specific market briefings by loading ~/openclaw-work/clients/<client>/config.json, harvesting configured web/RSS/API sources, and writing ~/openclaw-work/out/<client>/briefing_YYYY-MM-DD.md using the provided template. Use whenever a contributor needs a repeatable way to summarize market intel per client dossier.

Market Briefing Automation

Overview

This skill standardizes the production of daily or weekly market briefings tied to a client slug. It handles configuration handoff, source harvesting, and template-driven output so you can focus on synthesis instead of path wrangling.

Quick Start

1. Identify the client slug (matches folder under ~/openclaw-work/clients/).
2. Validate the config using the schema in references/config-schema.md. Populate sources + focus priorities.
3. Run the harvester:

   cd /Users/chenjiaxuan/openclaw/skills/market-briefing
   python scripts/generate_briefing.py --client <client-slug>
   

   Add --date YYYY-MM-DD for backfills. Use --init-dirs once if the client/out folders do not exist.
4. Open the generated file at ~/openclaw-work/out/<client>/briefing_<date>.md, replace placeholder bullets with your analysis, and attach links.

Workflow

1. Prepare Client Context

• Store each client's metadata in ~/openclaw-work/clients/<client>/config.json.
• Define focus topics in priority order—those become the talking points you highlight first.
• Make sure every source entry declares type, url, and either an HTML selector, an RSS feed, or API mapping. Lean on references/config-schema.md for examples.

2. Harvest Sources (Web / RSS / API)

• scripts/generate_briefing.py supports three modes: html (CSS selectors via BeautifulSoup), rss (XML parsing), and api (JSON payloads).
• Install dependencies once per environment:

  pip install requests beautifulsoup4
  

• Override --max-per-source to throttle noisy feeds; defaults to 5 headlines per source.
• The script logs warnings instead of failing hard when an endpoint is down—check stderr if a section looks empty.

3. Draft the Briefing

• Output lives in ~/openclaw-work/out/<client>/briefing_<date>.md and is pre-filled with the layout from assets/briefing-template.md.
• Auto-collected headlines are appended under "Auto-Collected Headlines" so you can decide what to elevate into the Executive Summary.
• Custom sections declared in config (e.g., "Commodities Watch") render with stub tables or bullet lists—overwrite them with real analysis.

4. QA & Delivery

• Sanity-check timestamp, timezone, and link formatting.
• Verify that each cited data point includes a working hyperlink.
• If multiple briefings run per day, re-run with --date to avoid overwriting or copy the file before iterating.

Scripts

Path	Purpose
scripts/generate_briefing.py	CLI helper that reads the client config, fetches sources, merges the markdown template, and writes the dated briefing file. Supports --dry-run to preview markdown and --init-dirs to bootstrap the client folder structure.

References & Assets

• references/config-schema.md: Contract for client configs, including directory expectations and source definitions.
• assets/briefing-template.md: Markdown skeleton injected into each output; edit once to change the default briefing layout across clients.