Capability Schema Reference Implementation

Reference Implementation of the Capability Schema Specification. This is not the Spec. The Spec lives in capability-schema-spec. This repo proves the Spec is implementable.

---

Quick Start

pip install capability-schema

# Or from source:
git clone https://github.com/nicklashansen/capability-schema-reference
cd capability-schema-reference
pip install -e .

What's Inside

capability_schema/
├── adapter/base.py         # WorldModelABC — 3 methods (encode, decode, step)
├── schema.py               # CapabilitySpec, Score, Evidence — Python SSOT
├── registry.py             # CapabilityRegistry — loads capabilities/*.yaml
└── observer/base.py        # MetricABC + PredictorABC + CalibrationBaseline

Usage

from capability_schema import CapabilitySpec, CapabilityRegistry

# Load a Capability definition
registry = CapabilityRegistry(search_paths=["path/to/capability-schema-spec"])
temporal_stability = registry.load("Temporal Stability")

print(temporal_stability.name)           # "Temporal Stability"
print(temporal_stability.observed_by)    # metrics=['delta_psnr'], predictors=['flow_instability']

Conformance

This implementation must pass the Conformance Test owned by the Spec repo.

There is no exemption for the Reference Implementation.

License

MIT — see LICENSE.

The Capability Schema Specification itself is CC BY 4.0.