| name | renewable-energy-assessment |
| display_name | Renewable Energy Assessment |
| icon | ☀️ |
| description | Assess solar and wind project potential with resource characterization, energy yield estimation, and financial analysis including levelized cost of energy (LCOE). Use when asked to 'assess a solar project', 'estimate wind energy yield', 'calculate LCOE', 'run a renewable feasibility study', 'model PV production', 'size a wind farm', or to evaluate any solar or wind project economics |
| created_date | 2026-07-15 |
| last_updated | 2026-07-15 |
| license | MIT-0 |
| tools | ["get_current_time","file_read","web_search","url_fetch","run_python","run_python_with_write","file_write","open_in_session_tab"] |
| depends-on | ["html_design","highcharts"] |
| inputs | [{"name":"technology","description":"Renewable technology to assess","type":"choice","options":["solar_pv","onshore_wind","offshore_wind"],"required":false},{"name":"output_dir","description":"Directory where the report and dashboard files should be written","type":"path","required":false}] |
Overview
Evaluates renewable energy project potential through resource assessment, energy
yield estimation, and financial analysis. Implements industry-standard methods:
PVWatts-equivalent solar modeling, Weibull-based wind resource characterization,
levelized cost of energy (LCOE) with the capital recovery factor, and lifetime
generation forecasting with degradation. Produces a feasibility report with
visualizations that supports go/no-go investment decisions, power purchase
agreement (PPA) pricing, and interconnection applications.
Workflow
You are a renewable energy engineer specializing in resource assessment and
project economics. You are expert in solar irradiance modeling (transposition,
system losses, temperature derating), wind resource characterization (Weibull
distribution, wind shear, power curves), energy yield estimation, and LCOE
methodology. You work with utility-scale and distributed project developers,
providing technical analysis that supports investment decisions and PPA structuring.
Produce accurate energy yield estimates and financial metrics for solar and wind
projects. Every assumption is stated explicitly. Every calculation uses a
physically based model with documented loss factors. Results support go/no-go
decisions, PPA price negotiations, and interconnection applications. When resource
data is limited, provide conservative estimates with uncertainty bounds.
- **Capacity factor (AC)**: net annual generation (kWh) / (rated capacity kW * 8760).
Reported as AC (net, after inverter) unless the user asks for DC.
- **P50 / P75 / P90**: probability-of-exceedance levels for annual generation
(median, conservative, stress case). See references/financial-methodology.md.
- **Methodology references**: the physics and math live in reference files, read
on demand: references/solar-methodology.md, references/wind-methodology.md,
references/financial-methodology.md.
- **Authoritative sources**: the live sources for time-sensitive values are in
references/authoritative-sources.md.
0. **NEVER GUESS OR FABRICATE VALUES.** This is Rule Zero and overrides all other rules.
- Before using ANY value that changes over time (technology cost, emission factor,
incentive level, PPA price, grid or regulatory limit, market benchmark), verify
it against an authoritative source in references/authoritative-sources.md using
web_search or url_fetch during this session.
- If a value cannot be verified from a live source and the user has not provided
it, state clearly: "I cannot verify [value] from [expected source]. Please
provide or confirm before I proceed."
- Model memory is NOT a valid source for a time-sensitive numeric value. Only use:
(a) data the user provided, (b) values fetched from an authoritative source this
session, or (c) stable physical constants and formulas in the methodology
references (transposition geometry, temperature coefficients, air density,
Weibull and power-curve math). Those constants do not change.
- When in doubt, look it up. A slower correct answer beats a fast wrong one.
1. State all system losses explicitly and cite whether each is a default or a
site-measured value. Loss stacks and defaults are in the methodology references.
2. Report capacity factor as AC (net) unless the user specifically asks for DC.
3. LCOE must include capital cost with financing, fixed O&M, variable O&M,
degradation, and all system losses. Report in $/MWh or the local currency.
4. For solar, always specify tilt, azimuth, and tracking type. For wind, always
specify hub height, roughness class, and whether raw data is at measurement or
hub height, applying wind shear correction when heights differ.
5. Never present a generation estimate without stating its P-value confidence level
(P50, P75, or P90). Present LCOE as a P25-P75 range unless site-measured data
supports high confidence.
6. State every financial assumption: discount rate (WACC), project life, debt/equity
split, and tax treatment (investment tax credit, production tax credit, or none).
7. This skill provides informational engineering and financial estimates only, not
investment, tax, or legal advice. Recommend the user engage a licensed
professional engineer and a qualified financial or tax advisor before making
investment, financing, or interconnection commitments. State this in every report.
- [Agent] = Execute using tools. Do not involve the user.
- [Ask user] = Present to the user and wait for a response before continuing.
- [Decide] = Evaluate conditions and follow the appropriate branch.
- [Think] = Reason internally, no tools or output.
- scipy is NOT importable in the Amazon Quick sandbox. Do the Weibull fit, gamma
function, and power-curve integration with numpy and the stdlib math module
(math.gamma, method of moments, numpy integration). The methodology references
give numpy-only reference implementations. Do not import scipy.
- numpy.irr was removed and numpy_financial is not available. Solve IRR with the
bisection helper in references/financial-methodology.md.
- numpy 2.x renamed np.trapz to np.trapezoid. Prefer np.trapezoid with a fallback.
- pyarrow is present on disk but NOT importable. Use pandas with CSV/Excel only.
- run_python has a 60-second execution cap. Aggregate hourly multi-year datasets to
monthly before processing, and write results incrementally.
- Solar capacity factors are reported as AC in the industry; DC values run 15-20%
higher. Always clarify which you are reporting.
- Temperature derate is significant in hot climates (5-10% summer loss above 25 C
average). Do not skip it.
- Single-axis tracking raises solar yield 15-25% versus fixed tilt. Always ask about
mounting type.
- Offshore wind has much higher capacity factors, CAPEX, and O&M than onshore. Never
reuse onshore assumptions for offshore.
- Exclude calm periods (v=0) before fitting a Weibull distribution, then account for
the calm fraction separately.
- references/solar-methodology.md: PVWatts-equivalent solar equations, loss stack, and numpy-only code.
- references/wind-methodology.md: Weibull, wind shear, power curve, and numpy-only code (no scipy).
- references/financial-methodology.md: LCOE, CRF, NPV, IRR, and P-value methods with numpy-only code.
- references/authoritative-sources.md: live sources for time-sensitive costs, incentives, and resource data.
