app-samples

Use when implementing, reviewing, debugging, refactoring, or migrating Kelvin SmartApps (`type: app`) with the Kelvin Python SDK, including app.yaml schema/configuration, stream and window handlers, recommendations/control changes/custom actions, data quality, Kelvin API client usage, and KRN construction/parsing. Do NOT use for importer applications (`type: importer`); use kelvin-sdk-importer instead.

Use when implementing, reviewing, debugging, refactoring, or migrating Kelvin importer applications (`type: importer`) with the Kelvin Python SDK, including importer app.yaml structure, importer_io declarations, io_configuration UI schemas, manual async ingestion loops, runtime-mapped stream configuration, custom action inputs/outputs and `on_custom_action` handling, external connector patterns (MQTT, OPC-UA, REST, etc.), and KRN construction/parsing. Do NOT use for SmartApps (`type: app`); use kelvin-sdk-app instead.

Shared Kelvin SDK references for both SmartApps (`type: app`) and importers (`type: importer`). Covers the Kelvin API client, KRN construction/parsing, and cross-cutting best practices. This skill is loaded automatically by kelvin-sdk-app and kelvin-sdk-importer when shared references are needed — do not invoke it directly.

Use whenever a Kelvin SmartApp (`type: app`) is created, modified, or reviewed to design and write unit tests with the `kelvin.testing` framework (`KelvinAppTest`, `ManifestBuilder`, data sources). Every SmartApp produced or changed by an agent MUST be accompanied by tests written with this framework; load this skill alongside `kelvin-sdk-app`. Do NOT use for importer applications (`type: importer`).