beaver_project/docs/superpowers/examples/mgm-galaxy-financial-chart-report-safe.SKILL.md

name, description, tools

name	description	tools
mgm-galaxy-financial-chart-report-safe	Compare MGM China and Galaxy Entertainment using official financial sources, produce chart-ready Markdown, and avoid claiming generated chart image/file artifacts.	web_search web_fetch

MGM/Galaxy Financial Chart Report Safe

Overview

Use this skill when the user asks for a finance comparison report for MGM China Holdings Limited and Galaxy Entertainment Group, especially when the requested output includes a table, chart-ready data, or a textual chart section.

The skill intentionally separates source collection, metric extraction, validation, and final reporting. It must not invent chart files or image artifacts. If the runtime does not expose a registered chart-rendering tool, the final output should be Markdown plus chart-ready data only.

{
  "version": 1,
  "strategy": "dag",
  "nodes": [
    {
      "node_id": "collect_official_sources",
      "task": "Collect official MGM China Holdings and Galaxy Entertainment financial disclosure sources for the requested period. Prefer annual reports, interim reports, results announcements, investor relations pages, and exchange filings. Return source URLs with short notes about period coverage.",
      "use_skill": "web-operation",
      "skill_query": "official financial disclosure web research",
      "depends_on": [],
      "requested_tools": ["web_search", "web_fetch"],
      "required_evidence": ["tool_result", "url"],
      "evidence_contract": {
        "version": 1,
        "entities": ["MGM China Holdings", "Galaxy Entertainment Group"],
        "source_types": ["annual_report", "interim_report", "results_announcement", "investor_relations", "exchange_filing"],
        "minimum_sources_per_entity": 1
      },
      "validation_rules": [
        "Prefer official company, investor relations, HKEX, or stock exchange sources.",
        "Record the reporting period attached to each source.",
        "Do not use unsourced market commentary as primary evidence."
      ],
      "required_for_completion": true,
      "block_downstream_on_partial": true,
      "max_tool_iterations": 4,
      "constraints": [
        "Use only public pages.",
        "Do not require login or paid databases."
      ]
    },
    {
      "node_id": "extract_financial_metrics",
      "task": "Extract comparable financial metrics for MGM China Holdings and Galaxy Entertainment from the collected official sources. Include revenue or net revenue, adjusted EBITDA where available, net profit/loss where available, period, currency, unit, and source URL for each metric.",
      "skill_query": "financial metric extraction from official disclosures",
      "depends_on": ["collect_official_sources"],
      "requested_tools": ["web_fetch"],
      "required_evidence": ["output"],
      "evidence_contract": {
        "version": 1,
        "metrics": ["revenue", "adjusted_ebitda", "net_profit_or_loss"],
        "required_fields": ["company", "period", "metric", "value", "currency", "unit", "source_url"]
      },
      "validation_rules": [
        "Keep currencies and units explicit.",
        "Do not compare different reporting periods without labeling the mismatch.",
        "Mark unavailable metrics as unavailable instead of estimating them."
      ],
      "required_for_completion": true,
      "block_downstream_on_partial": true,
      "max_tool_iterations": 2,
      "constraints": [
        "Use upstream official sources before searching for alternatives."
      ]
    },
    {
      "node_id": "validate_metrics",
      "task": "Validate extracted metrics for source consistency, period alignment, currency/unit consistency, and obvious transcription errors. Produce a concise validation note and list any evidence gaps.",
      "skill_query": "finance metric validation",
      "depends_on": ["extract_financial_metrics"],
      "requested_tools": [],
      "required_evidence": ["output"],
      "evidence_contract": {
        "version": 1,
        "checks": ["source_consistency", "period_alignment", "currency_unit_consistency", "transcription_sanity"]
      },
      "validation_rules": [
        "Do not introduce new unsourced figures.",
        "If values are not comparable, explain why and preserve both values with labels."
      ],
      "required_for_completion": true,
      "block_downstream_on_partial": true,
      "max_tool_iterations": 0,
      "constraints": [
        "No tools in this validation node; use upstream evidence only."
      ]
    },
    {
      "node_id": "generate_chart_report",
      "task": "Generate the final Markdown comparison report. Include an executive summary, source-backed comparison table, chart-ready data table, optional Mermaid or text bar chart section, and caveats. Do not claim that a chart image, chart file, or saved artifact was generated.",
      "skill_query": "financial markdown report with chart-ready data",
      "depends_on": ["validate_metrics"],
      "requested_tools": [],
      "required_evidence": ["output"],
      "evidence_contract": {
        "version": 1,
        "outputs": ["comparison_table", "chart_ready_data", "markdown_report"],
        "forbidden_claims": ["generated_chart_image", "generated_chart_file", "saved_chart_artifact"]
      },
      "validation_rules": [
        "Every numeric claim must trace back to a source URL or be marked unavailable.",
        "Do not claim a generated image/file unless a registered chart renderer tool was actually used.",
        "Prefer Markdown tables and chart-ready data over unsupported rendering claims."
      ],
      "required_for_completion": true,
      "block_downstream_on_partial": false,
      "max_tool_iterations": 0,
      "constraints": [
        "No chart renderer is assumed.",
        "No file/image artifact claims."
      ]
    }
  ]
}

When to Use

• The user asks to compare MGM China and Galaxy Entertainment financial performance.
• The user asks for a chart, chart-ready data, Markdown chart section, or board-style finance report.
• The task requires source-backed public financial data rather than generic market commentary.

Required Tools

• web_search
• web_fetch

Workflow

1. Collect official sources first: company investor relations pages, annual/interim reports, results announcements, and exchange filings.
2. Extract comparable metrics with period, currency, unit, and source URL.
3. Validate that metrics are comparable before drawing conclusions.
4. Produce a Markdown report with comparison table and chart-ready data.
5. If a real chart renderer tool is unavailable, say so implicitly by providing chart-ready data; do not claim an image or file was created.

Validation

• Confirm each company has at least one official source.
• Confirm all numeric metrics carry period, currency, unit, and source URL.
• Confirm the final report does not contain claims such as “saved chart image”, “generated chart file”, or “attached chart artifact”.

Boundaries

• Do not use private, paid, or login-only sources.
• Do not fabricate unavailable figures.
• Do not use high-risk write, terminal, email, or external-send tools.
• Do not create nested teams or role-based agents.
• Do not claim chart rendering unless the runtime exposes and actually uses a registered chart-renderer tool.