Open Skills Initiative

Add a calculation others can run

One reference skill ships today. The inventory below is a roadmap, not a catalog.

Reference skill: lcoe-calculator

Why Contribute Open Skills?

Reusable calculation logic

You contribute a Python script that takes JSON in and returns JSON out. Reviewers run the tests. The desk and agents call the same module later — you do not have to learn the rest of the runtime.

Public methods, not trade secrets

Skills encode public methodologies: NREL's LCOE formula, EPA emission factors, GHG Protocol calculations. This is procedural knowledge, not trade secrets.

Tests and examples ship with it

A merged skill includes fixtures a reviewer can replay. The same calculation runs every time the module is invoked — not a one-off notebook.

“Stop building bespoke agents for every task. Build reusable Skills that any agent can invoke. Code is the universal interface.”

— Skills-First Architecture Philosophy

How to Contribute

1

Choose a Skill Gap

Review the skills inventory below and pick one marked as 'needed' that matches your expertise.

2

Follow the Template

Use the lcoe-calculator as your reference implementation. Copy the folder structure and adapt it.

3

Write Python Scripts

Implement your calculation using only Python standard library. Accept JSON input, output JSON.

4

Add Tests & Examples

Include test cases and example inputs so others can validate and learn from your work.

5

Submit a Pull Request

Open a PR to the greencio repository. Maintainers review and integrate accepted skills.

Skill Folder Structure

skills/
└── your-skill-name/
    ├── skill.md              # Entry point with YAML metadata
    ├── scripts/
    │   ├── calculate.py      # Main calculation (JSON in/out)
    │   └── requirements.txt  # Dependencies (prefer none)
    ├── schemas/
    │   ├── input.schema.json
    │   └── output.schema.json
    ├── examples/
    │   └── sample_input.json
    └── tests/
        └── test_calculate.py

Skills Inventory

See what's available and what's needed. Skills marked as “needed” are opportunities for contribution.

Financial Modeling

lcoe-calculator

Levelized Cost of Energy

Open calculator
compute-options-strategy

GPU-hour options, positions, and reserve-call strips

Open calculator
substation-economics

Modular AI substation unit economics

Open calculator
project-npv-irr

NPV/IRR/Payback modeling

Planned
carbon-price-modeler

Carbon price scenarios

Planned
green-bond-analyzer

Green bond verification

Planned

Emissions & Carbon

carbon-footprint

Scope 1/2/3 calculator

Planned
emissions-reporter

CDP/GRI/SASB formatter

Planned
offset-validator

Carbon offset quality scoring

Planned

Grid & Energy

load-forecaster

Demand time-series forecasting

Planned
curtailment-optimizer

Peak load optimization

Planned
solar-yield

PV generation calculator

Planned
wind-yield

Wind generation calculator

Planned

Contracts & Compliance

ppa-analyzer

Power Purchase Agreement parser

Planned
rec-tracker

Renewable certificate management

Planned
cbam-compliance

EU Carbon Border Adjustment Mechanism checker

Planned
sec-climate-disclosure

SEC climate risk formatter

Planned

Asset Management

predictive-maintenance

ML-based maintenance scheduling

Planned
battery-lifecycle

Storage degradation modeling

Planned
equipment-lifecycle

Replacement timing optimizer

Planned

Recognition for Contributors

Every skill includes attribution in its metadata. Contributors are recognized in:

skill.md

Author field in frontmatter

Directory

Listed once the skill ships

This Page

Skills inventory credits

Have a skill to contribute?

Walk through it with the team, or email skills@greencio.com.