carbon-cost-pair
Pair every cloud spend value with a kgCO2e estimate by region and service category for CSRD and SEC climate disclosure. Input is region, service category, and dollar value; output is paired kgCO2e with confidence label (vendor-published, third-party, or estimated) and source cita
Install
npx skills add https://github.com/VincentChuWaiChow/vanguard-frontier-agentic/tree/master/skills/finops/carbon-cost-pair
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install vincentchuwaichow-vanguard-frontier-agentic@llmmart
git clone https://github.com/VincentChuWaiChow/vanguard-frontier-agentic.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole vincentchuwaichow/vanguard-frontier-agentic collection as a plugin from our marketplace. Git is the plain clone.
README
Carbon Cost Pair
A FinOps skill that pairs cloud spend values with kgCO2e carbon estimates by region and service category, with mandatory confidence labels and source citations for CSRD and SEC climate disclosure.
Purpose
For every cloud spend line item, produce a paired kgCO2e estimate using the best available carbon factor for the cloud region and service category. Confidence is labeled as vendor-published, third-party, or estimated, and every output includes a source URL and data period acknowledgment.
Allowed tools
Read Grep Glob WebFetch
Usage
Single line item: Provide cloud provider, region, service category, and dollar value (e.g., "Pair $1,200 of AWS us-east-1 compute spend with a carbon estimate"). The skill fetches the latest available carbon factor, applies it, and returns a labeled kgCO2e output with FOCUS tag mapping.
Multi-line comparison: Provide multiple regions or providers (e.g., "Compare carbon intensity for the same $10,000 compute spend across AWS us-east-1, Azure eastus, and GCP us-central1"). The skill returns one estimate block per line item plus a summary comparison table.
Trust posture
Read-only. No cloud credentials, billing account IDs, or tenant data accepted. Carbon factors are fetched from public provider sustainability pages or third-party sources. Provider data typically lags 60-90 days; the data period is stated in every output.
Defaults to Scope 2 electricity-only, market-based factors. Location-based and Scope 1+2 available on request.
See SKILL.md for the full operating rules, confidence label decision tree, regulatory context, and output shape.
Skill manifest
Carbon Cost Pair
Purpose
For every cloud spend line item, produce a paired kgCO2e estimate suitable for CSRD and SEC climate disclosure. The skill pairs a dollar value (or resource quantity) with the best available carbon emissions factor for the given cloud region and service category, and returns the estimate with a mandatory confidence label and source citation.
No cloud credentials accepted. Carbon factors are fetched from provider sustainability pages or third-party sources.
When to use
Use this skill when:
- The user needs to pair a cloud spend or usage figure with a carbon estimate for sustainability reporting (CSRD Article 29a, SEC climate rule, GHG Protocol Scope 2)
- The user wants to compare the carbon intensity of the same workload across cloud regions or providers
- The user wants to understand the confidence level of a carbon estimate before including it in a regulatory disclosure
Operating rules
- Default to electricity-only Scope 2, market-based. Unless the caller specifies otherwise, compute Scope 2 emissions using market-based electricity factors (renewable energy certificate or PPA-adjusted). Location-based factors are available on request.
- Fetch live data first. Use WebFetch to retrieve the latest carbon factor data from the provider's sustainability API or dashboard before falling back to documentation-based estimates.
- Confidence labels mandatory. Every kgCO2e output must carry exactly one label:
vendor-published— factor sourced from the provider's own sustainability API, dashboard, or data export within this session (include source URL and ISO 8601 timestamp)third-party— factor sourced from Electricity Maps, Cloud Carbon Footprint project, or equivalent third-party source (include source URL and timestamp)estimated— factor derived from regional grid average or published industry emission factors where no provider or third-party data is available (state the factor, source, and assumptions)
- No credentials accepted. No cloud credentials, billing account IDs, tenant data, or sustainability API tokens are accepted or required.
- Acknowledge data lag. Provider carbon data typically lags 60-90 days or more. State the data period whenever citing vendor-published factors.
- FOCUS column mapping. There are no native FOCUS v1.2 carbon columns. Represent carbon estimates as FOCUS tags:
Tags/kgco2e,Tags/carbon_confidence,Tags/carbon_source. - Load references only when needed.
Input
| Field | Required | Description |
|---|---|---|
| Cloud provider | Yes | AWS, Azure, Google Cloud, OCI, or multi-cloud |
| Region | Yes | Provider region name (e.g., us-east-1, eastus, us-central1, ap-sydney-1) |
| Service category | Yes | Compute, Storage, Networking, AI and Machine Learning, Databases, or Other |
| Dollar value ($) | Yes | The spend amount to pair with a carbon estimate |
| Resource quantity | Optional | If available, the underlying resource quantity (e.g., vCPU-hours, GiB-hours, GB transferred) for a more precise estimate |
| Scope preference | Optional | Default: Scope 2 market-based. Options: scope2-market, scope2-location, scope1+2 |
Output shape
Return, per line item:
Region: <provider region>
Service category: <category>
Dollar value: $<amount>
kgCO2e estimate: <value> kgCO2e [<confidence label>]
Scope: Scope 2 (market-based) | Scope 2 (location-based)
Data period: <e.g., Q3 2025 or "Current as of 2026-05-13">
Source: <URL> (fetched: <ISO 8601 timestamp> | documentation date: <date>)
Methodology note: <one sentence describing the emission factor used>
FOCUS tags:
Tags/kgco2e: <value>
Tags/carbon_confidence: <vendor-published | third-party | estimated>
Tags/carbon_source: <URL>
If multiple regions or service categories are provided, return one block per line item followed by a summary table.
Confidence label decision tree
- Does the cloud provider publish a region-level carbon factor or API for this region and service?
- Yes, and it was fetched this session →
vendor-published - Yes, but the fetch failed or data is not current → proceed to step 2
- Yes, and it was fetched this session →
- Is Electricity Maps data available for the grid region, or is Cloud Carbon Footprint data available for this provider/region?
- Yes →
third-party
- Yes →
- Fall back to IEA regional grid average emission factor or the provider's country-level average.
- →
estimated; state the factor used (e.g.,0.386 kgCO2e/kWh — IEA 2023 US average)
- →
Regulatory context
- CSRD (Corporate Sustainability Reporting Directive): requires disclosure of Scope 1, 2, and 3 emissions under ESRS E1. Cloud compute is typically Scope 2 (purchased electricity) and may contribute to Scope 3 Category 1 (purchased goods/services) for customers.
- SEC Climate Rule: requires material climate-related disclosures including Scope 1 and 2 emissions for large accelerated filers.
- GHG Protocol: defines market-based and location-based approaches for Scope 2. Both may be required; market-based is the default here.
References
Load these only when needed:
- Carbon data sources — provider sustainability API URLs, third-party data sources, and fallback options.
- Methodology — market-based vs location-based Scope 2, data lag, and uncertainty labeling.
Files (vanguard-frontier-agentic)
-
references
-
methodology.md 5 KB
# Carbon Emission Methodology ## Scope 2 emissions: market-based vs location-based Scope 2 emissions are indirect greenhouse gas emissions from the generation of purchased electricity consumed by an organization. The GHG Protocol defines two methods for Scope 2 accounting: ### Market-based method Uses emission factors from contractual instruments that convey attributes of the electricity consumed, such as: - Renewable Energy Certificates (RECs) or Guarantees of Origin (GOs) - Power Purchase Agreements (PPAs) with specific generators - Supplier-specific emission factors published by utilities Effect: when a cloud provider purchases RECs or PPAs covering 100% of their electricity use in a region, the market-based Scope 2 emission factor for that region approaches zero. This is why hyperscaler-reported Scope 2 figures are often significantly lower than location-based figures. Default in this skill: **market-based**, because it reflects the cloud provider's actual contractual commitments and is the value reported in vendor sustainability disclosures. ### Location-based method Uses average emission factors for the electricity grid(s) where consumption occurs, regardless of contractual instruments. These factors are typically published by grid operators or national energy agencies (e.g., EPA eGRID for US, AIB residual mixes for Europe). The location-based figure represents what emissions would have been if the electricity came from the average mix of sources on the local grid. Both methods may be required for CSRD (ESRS E1) and GHG Protocol dual-reporting. ## Data lag Provider carbon data typically lags the billing period by 60-90 days or more: - AWS Customer Carbon Footprint Tool: approximately 3 months lag. - Microsoft Emissions Impact Dashboard: approximately 2-3 months lag. - Google Cloud Carbon Footprint: approximately 2 months lag. - Third-party (Electricity Maps historical): 24-hour lag for the previous day; monthly averages available sooner. Implication for disclosure: carbon estimates produced for a quarter's cloud spend will be based on emission factors from the same or a prior quarter. Always state the data period when citing vendor-published factors. ## How to label uncertainty Every kgCO2e output must carry one of three confidence labels with the stated basis: | Label | When to use | What to state | |---|---|---| | `vendor-published` | Provider's own sustainability API or dashboard data was retrieved | Source URL, data period (e.g., "Q3 2025"), fetch timestamp | | `third-party` | Electricity Maps or Cloud Carbon Footprint data was used | Source URL, date of data, which grid zone was used | | `estimated` | Regional or national grid average used as fallback | Emission factor (kgCO2eq/kWh), source (e.g., IEA 2023), year of data | Do not present a kgCO2e figure without one of these labels. If a value cannot be computed with any of the three approaches, state that a carbon estimate is not available for this region or service category and explain why. ## Conversion from $/spend to kgCO2e When only a dollar spend value is provided (not resource quantity), a spend-based emission factor is required. These are less precise than activity-based factors (kgCO2e per kWh or per vCPU-hour) because price varies by region, service type, and over time. If the provider publishes a spend-normalized factor (kgCO2e/$) for the relevant service or region, use it and label as `vendor-published`. If no spend-normalized factor is available, prefer an activity-based route: 1. Estimate the resource quantity from the spend (e.g., divide by on-demand price per vCPU-hour to get vCPU-hours). 2. Multiply vCPU-hours by the energy use per vCPU-hour (typical: 0.0025 kWh for a modern data center instance). 3. Multiply energy use by the regional emission factor (kgCO2eq/kWh). State each step and label the result `estimated` unless the emission factor was fetched from a vendor or third-party source. ## Scope 1 emissions (note) Scope 1 emissions (direct on-site combustion) from cloud data centers — backup generators, on-site equipment — are typically immaterial compared to Scope 2 and are not separately published by cloud providers per customer. Unless the caller specifically requests Scope 1, this skill produces Scope 2 only. ## Regulatory framing | Framework | Requirement relevant to cloud | |---|---| | CSRD / ESRS E1 | Gross Scope 1, 2, and 3 by category; both market-based and location-based Scope 2; alignment with GHG Protocol | | SEC Climate Rule | Material Scope 1 and 2; Scope 3 if material or targeted; large accelerated filers required to include | | GHG Protocol Corporate Standard | Both market-based and location-based Scope 2 recommended; Scope 3 Category 1 (purchased goods/services) may include cloud | Cloud emissions typically appear in: - Scope 2 (electricity) for compute, storage, and networking in data centers - Scope 3 Category 1 (purchased goods and services) for cloud spend treated as a supply chain input This skill computes Scope 2 (electricity) only unless the caller specifies otherwise. -
sources.md 5.7 KB
# Carbon Data Sources ## Provider sustainability data (vendor-published) ### AWS — Customer Carbon Footprint Tool | Resource | URL | |---|---| | Tool overview | https://aws.amazon.com/aws-cost-management/aws-customer-carbon-footprint-tool/ | | Documentation | https://docs.aws.amazon.com/cur/latest/userguide/ccft-overview.html | | Methodology | https://docs.aws.amazon.com/cur/latest/userguide/ccft-methodology.html | AWS Customer Carbon Footprint Tool provides estimated carbon emissions for AWS usage in metric tons of CO2 equivalent (MTCO2e) broken down by service, region, and time period. Data is available through the AWS console and the AWS Cost Explorer API. Important notes: - Data typically lags approximately 3 months (90 days). - Figures reflect AWS's own renewable energy purchases (market-based Scope 2). - Location-based figures are also available in the methodology documentation. - The tool does not expose a public unauthenticated API; for live fetch, use WebFetch against the public documentation and methodology pages, which publish the aggregate emission factors and regional renewable energy percentages. For unauthenticated access to AWS carbon methodology data, fetch from: - https://docs.aws.amazon.com/cur/latest/userguide/ccft-methodology.html - https://sustainability.aboutamazon.com/ ### Microsoft — Cloud for Sustainability Emissions API | Resource | URL | |---|---| | Industry sustainability hub | https://learn.microsoft.com/en-us/industry/sustainability/ | | Emissions Impact Dashboard | https://www.microsoft.com/en-us/sustainability/emissions-impact-dashboard | | Microsoft Sustainability Manager docs | https://learn.microsoft.com/en-us/industry/sustainability/sustainability-manager-overview | Microsoft publishes carbon data through the Emissions Impact Dashboard (Power BI report, not unauthenticated API) and the Microsoft Cloud for Sustainability APIs. For unauthenticated reference data, use: - https://www.microsoft.com/en-us/sustainability/reports (annual sustainability report with regional energy data) - https://learn.microsoft.com/en-us/azure/carbon-optimization/ (Azure carbon optimization documentation) Data lag: typically 2-3 months behind current billing. ### Google Cloud — Carbon Footprint Export | Resource | URL | |---|---| | Documentation | https://cloud.google.com/carbon-footprint/docs | | Methodology | https://cloud.google.com/carbon-footprint/docs/methodology | | Region carbon data | https://cloud.google.com/sustainability/region-carbon | Google Cloud Carbon Footprint provides gross and net carbon emissions per product and region. The regional carbon data page publishes the carbon-free energy percentage per region, which can be combined with regional grid intensity to estimate net Scope 2 emissions. For unauthenticated reference: - https://cloud.google.com/sustainability/region-carbon — carbon-free energy percentages per region; fetch this page with WebFetch. - https://cloud.google.com/carbon-footprint/docs/methodology — describes the market-based and location-based calculation approach. ### OCI — Sustainability Dashboard | Resource | URL | |---|---| | OCI Sustainability overview | https://www.oracle.com/sustainability/ | | Oracle sustainability report | https://www.oracle.com/corporate/citizenship/ | OCI does not publish a per-region unauthenticated carbon API equivalent to AWS CCFT or Google Cloud Carbon Footprint. For OCI carbon estimates, fall back to the Electricity Maps regional data for the grid serving the OCI data center, or use the Cloud Carbon Footprint project's OCI emission factors. ## Third-party sources ### Electricity Maps | Resource | URL | |---|---| | Global carbon intensity map | https://www.electricitymaps.com/ | | API documentation | https://static.electricitymaps.com/api/docs/index.html | | Open data | https://github.com/electricitymaps/electricitymaps-contrib | Electricity Maps publishes real-time and historical grid carbon intensity (gCO2eq/kWh) for electricity grids worldwide. This is suitable for location-based Scope 2 calculations. The public API requires an API key for live data; the open data repository on GitHub contains historical zone data accessible without authentication. For unauthenticated WebFetch, use the public zone data from the GitHub repository. ### Cloud Carbon Footprint Project | Resource | URL | |---|---| | Project site | https://www.cloudcarbonfootprint.org/ | | Emission factors repository | https://github.com/cloud-carbon-footprint/cloud-carbon-footprint | | Coefficient data | https://github.com/cloud-carbon-footprint/cloud-carbon-footprint/blob/trunk/packages/gcp/src/domain/GcpFootprintEstimationConstants.ts | The Cloud Carbon Footprint project publishes open-source emission coefficients for AWS, Azure, and GCP including per-region grid intensity and average embodied carbon for common instance types. These are community-maintained, not vendor-published, and should be labeled `third-party`. ## IEA and national grid averages (fallback) If neither vendor nor third-party data is available for a region: | Source | URL | |---|---| | IEA CO2 emissions from electricity data | https://www.iea.org/data-and-statistics/data-product/emissions-factors-2023 | | EPA eGRID (US) | https://www.epa.gov/egrid | Use the regional or national grid average in kgCO2eq/kWh and multiply by the estimated kWh consumed. Label as `estimated` and state the factor and its source year. ## Source selection priority When multiple sources are available, use the highest-confidence source available: 1. Vendor-published (provider sustainability API or dashboard documentation for the specific region) 2. Third-party (Electricity Maps or Cloud Carbon Footprint for the specific grid region) 3. Estimated (IEA or EPA national/regional average, clearly labeled)
-
-
metadata.json 1.2 KB
{ "id": "carbon-cost-pair", "name": "Carbon Cost Pair", "type": "skill", "provider": "multi-cloud", "harnesses": [ "codex", "claude-code", "cursor", "gemini", "kiro", "other" ], "summary": "Pair cloud spend values with kgCO2e estimates by region and service category for CSRD and SEC climate disclosure. Outputs confidence-labeled carbon estimates (vendor-published, third-party, or estimated) with source citations. Defaults to Scope 2 market-based electricity factors.", "source_type": "original", "official_docs": [ "https://aws.amazon.com/aws-cost-management/aws-customer-carbon-footprint-tool/", "https://learn.microsoft.com/en-us/industry/sustainability/", "https://cloud.google.com/carbon-footprint/docs" ], "security_notes": "No cloud credentials, billing account IDs, sustainability API tokens, or tenant-specific data are accepted or required. All carbon factors are fetched from public provider sustainability pages or third-party data sources. No write operations to any system are performed.", "last_verified": "2026-05-13", "path": "skills/finops/carbon-cost-pair", "author": "github: VincentChuWaiChow", "version": "0.1.1", "lifecycle": "experimental" } -
README.md 1.6 KB
# Carbon Cost Pair A FinOps skill that pairs cloud spend values with kgCO2e carbon estimates by region and service category, with mandatory confidence labels and source citations for CSRD and SEC climate disclosure. ## Purpose For every cloud spend line item, produce a paired kgCO2e estimate using the best available carbon factor for the cloud region and service category. Confidence is labeled as `vendor-published`, `third-party`, or `estimated`, and every output includes a source URL and data period acknowledgment. ## Allowed tools `Read` `Grep` `Glob` `WebFetch` ## Usage **Single line item:** Provide cloud provider, region, service category, and dollar value (e.g., "Pair $1,200 of AWS us-east-1 compute spend with a carbon estimate"). The skill fetches the latest available carbon factor, applies it, and returns a labeled kgCO2e output with FOCUS tag mapping. **Multi-line comparison:** Provide multiple regions or providers (e.g., "Compare carbon intensity for the same $10,000 compute spend across AWS us-east-1, Azure eastus, and GCP us-central1"). The skill returns one estimate block per line item plus a summary comparison table. ## Trust posture Read-only. No cloud credentials, billing account IDs, or tenant data accepted. Carbon factors are fetched from public provider sustainability pages or third-party sources. Provider data typically lags 60-90 days; the data period is stated in every output. Defaults to Scope 2 electricity-only, market-based factors. Location-based and Scope 1+2 available on request. See [SKILL.md](SKILL.md) for the full operating rules, confidence label decision tree, regulatory context, and output shape. -
SKILL.md 5.9 KB
--- name: carbon-cost-pair description: Pair every cloud spend value with a kgCO2e estimate by region and service category for CSRD and SEC climate disclosure. Input is region, service category, and dollar value; output is paired kgCO2e with confidence label (vendor-published, third-party, or estimated) and source citation. Defaults to electricity-only Scope 2 market-based factors. allowed-tools: Read Grep Glob WebFetch metadata: author: "github: VincentChuWaiChow" version: "0.1.1" updated: "2026-05-13" category: finops lifecycle: experimental --- # Carbon Cost Pair ## Purpose For every cloud spend line item, produce a paired kgCO2e estimate suitable for CSRD and SEC climate disclosure. The skill pairs a dollar value (or resource quantity) with the best available carbon emissions factor for the given cloud region and service category, and returns the estimate with a mandatory confidence label and source citation. No cloud credentials accepted. Carbon factors are fetched from provider sustainability pages or third-party sources. ## When to use Use this skill when: - The user needs to pair a cloud spend or usage figure with a carbon estimate for sustainability reporting (CSRD Article 29a, SEC climate rule, GHG Protocol Scope 2) - The user wants to compare the carbon intensity of the same workload across cloud regions or providers - The user wants to understand the confidence level of a carbon estimate before including it in a regulatory disclosure ## Operating rules - **Default to electricity-only Scope 2, market-based.** Unless the caller specifies otherwise, compute Scope 2 emissions using market-based electricity factors (renewable energy certificate or PPA-adjusted). Location-based factors are available on request. - **Fetch live data first.** Use WebFetch to retrieve the latest carbon factor data from the provider's sustainability API or dashboard before falling back to documentation-based estimates. - **Confidence labels mandatory.** Every kgCO2e output must carry exactly one label: - `vendor-published` — factor sourced from the provider's own sustainability API, dashboard, or data export within this session (include source URL and ISO 8601 timestamp) - `third-party` — factor sourced from Electricity Maps, Cloud Carbon Footprint project, or equivalent third-party source (include source URL and timestamp) - `estimated` — factor derived from regional grid average or published industry emission factors where no provider or third-party data is available (state the factor, source, and assumptions) - **No credentials accepted.** No cloud credentials, billing account IDs, tenant data, or sustainability API tokens are accepted or required. - **Acknowledge data lag.** Provider carbon data typically lags 60-90 days or more. State the data period whenever citing vendor-published factors. - **FOCUS column mapping.** There are no native FOCUS v1.2 carbon columns. Represent carbon estimates as FOCUS tags: `Tags/kgco2e`, `Tags/carbon_confidence`, `Tags/carbon_source`. - **Load references only when needed.** ## Input | Field | Required | Description | |---|---|---| | Cloud provider | Yes | AWS, Azure, Google Cloud, OCI, or multi-cloud | | Region | Yes | Provider region name (e.g., `us-east-1`, `eastus`, `us-central1`, `ap-sydney-1`) | | Service category | Yes | Compute, Storage, Networking, AI and Machine Learning, Databases, or Other | | Dollar value ($) | Yes | The spend amount to pair with a carbon estimate | | Resource quantity | Optional | If available, the underlying resource quantity (e.g., vCPU-hours, GiB-hours, GB transferred) for a more precise estimate | | Scope preference | Optional | Default: Scope 2 market-based. Options: `scope2-market`, `scope2-location`, `scope1+2` | ## Output shape Return, per line item: ``` Region: <provider region> Service category: <category> Dollar value: $<amount> kgCO2e estimate: <value> kgCO2e [<confidence label>] Scope: Scope 2 (market-based) | Scope 2 (location-based) Data period: <e.g., Q3 2025 or "Current as of 2026-05-13"> Source: <URL> (fetched: <ISO 8601 timestamp> | documentation date: <date>) Methodology note: <one sentence describing the emission factor used> FOCUS tags: Tags/kgco2e: <value> Tags/carbon_confidence: <vendor-published | third-party | estimated> Tags/carbon_source: <URL> ``` If multiple regions or service categories are provided, return one block per line item followed by a summary table. ## Confidence label decision tree 1. Does the cloud provider publish a region-level carbon factor or API for this region and service? - Yes, and it was fetched this session → `vendor-published` - Yes, but the fetch failed or data is not current → proceed to step 2 2. Is Electricity Maps data available for the grid region, or is Cloud Carbon Footprint data available for this provider/region? - Yes → `third-party` 3. Fall back to IEA regional grid average emission factor or the provider's country-level average. - → `estimated`; state the factor used (e.g., `0.386 kgCO2e/kWh — IEA 2023 US average`) ## Regulatory context - **CSRD (Corporate Sustainability Reporting Directive)**: requires disclosure of Scope 1, 2, and 3 emissions under ESRS E1. Cloud compute is typically Scope 2 (purchased electricity) and may contribute to Scope 3 Category 1 (purchased goods/services) for customers. - **SEC Climate Rule**: requires material climate-related disclosures including Scope 1 and 2 emissions for large accelerated filers. - **GHG Protocol**: defines market-based and location-based approaches for Scope 2. Both may be required; market-based is the default here. ## References Load these only when needed: - [Carbon data sources](references/sources.md) — provider sustainability API URLs, third-party data sources, and fallback options. - [Methodology](references/methodology.md) — market-based vs location-based Scope 2, data lag, and uncertainty labeling.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.