Skip to content
Agent Skill Hub
VI

python-azure-iot-edge-modules

Build and operate Python Azure IoT Edge modules with manifests, reliability and security

iotazure-iot-edge
Compatible agents:
  • GitHub Copilot

View on GitHubmain @ 421418940.2k GitHub stars5.2k forksupdated Aug 7, 2026

Original description (for the agent)

Build and operate Python Azure IoT Edge modules with robust messaging, deployment manifests, observability, and production readiness checks.

What this skill does

  • You provide: your edge module requirements, such as filtering or aggregating sensor data before cloud upload, local inference or protocol translation.
  • How it works: goes through 5 steps: define interfaces, runtime and packaging, design for disconnects and retries, security controls, and deployment with a manifest. It requires checking Microsoft's IoT Edge docs before recommending.
  • You get: a module design brief, a deployment model (image, manifest, env settings), an error-handling strategy, a security and operations checklist and a test matrix (functional, chaos, performance, rollback).
  • You need: access to the Microsoft IoT Edge docs and the official Python docs for the skill to check; if they cannot be fetched, the skill flags its assumptions explicitly.
  • Note: the skill will not recommend a direct production rollout without a pilot stage, and never embeds secrets in code, Dockerfiles or manifests. Its example requests are in Spanish.

Python Azure IoT Edge Modules

Use this skill to design, implement, and validate Python-based IoT Edge modules for telemetry processing, local inference, protocol translation, and edge-to-cloud integration.

When To Use

Use this skill for requests like:

  • "quiero crear un modulo Python para IoT Edge"
  • "como despliego modulos edge con manifest"
  • "necesito filtrar/agregar telemetria antes de subirla"
  • "como manejo desconexiones y reintentos en edge"

Mandatory Docs Review

Before recommending runtime behavior or deployment decisions, review:

Minimum checks:

  • Runtime architecture and module lifecycle.
  • Supported host OS and versions.
  • Deployment model and configuration flow.
  • Current release/version guidance.

If documentation cannot be fetched, proceed with explicit assumptions and flag them clearly.

Python Official References and Best Practices (Required)

Before proposing Python implementation details, consult official Python sources:

Prefer official docs over community snippets unless there is a specific compatibility reason to deviate.

Goals

  • Deliver module architecture and implementation plan that is production-focused.
  • Ensure reliable edge messaging under network variability.
  • Provide deployment, observability, and validation artifacts.

Module Use Cases

  • Protocol adapter (serial/Modbus/OPC-UA to IoT message format).
  • Telemetry enrichment and normalization.
  • Local anomaly detection or inference.
  • Command orchestration and local actuator control.

Delivery Workflow

1) Contract and Interfaces

Define:

  • Module inputs and outputs.
  • Message schema and versioning policy.
  • Routes and priorities for normal vs critical telemetry.
  • Desired properties used for dynamic configuration.

2) Runtime and Packaging

Specify:

  • Python runtime version target.
  • Container image strategy (base image, slim footprint, CVE hygiene).
  • Resource profile (CPU/memory bounds).
  • Startup and health checks.

3) Reliability Design

Implement and validate:

  • Retries with exponential backoff and jitter.
  • Graceful degradation on upstream failures.
  • Local queueing strategy where needed.
  • Idempotent processing for replayed messages.

4) Security Controls

Require:

  • No plaintext secrets in code or manifest.
  • Least-privilege module behavior.
  • Secure transport and trusted cert chain handling.
  • Traceability for command handling and state changes.

5) Deployment and Operations

Define:

  • Environment-specific deployment manifests.
  • Rollout strategy (pilot, staged, broad).
  • Rollback criteria.
  • SLOs and alerting conditions.

Reuse Other Skills

When relevant, combine with:

  • azure-smart-city-iot-solution-builder for platform-level architecture.
  • appinsights-instrumentation for telemetry instrumentation approaches.
  • azure-resource-visualizer for architecture diagrams and dependency mapping.

Also use references/python-official-best-practices.md as baseline quality criteria for module design and implementation guidance.

Required Output

Always provide:

  1. Module design brief (purpose, inputs, outputs).
  2. Deployment model (image, manifest, env settings).
  3. Reliability and error-handling strategy.
  4. Security and operations checklist.
  5. Test matrix (functional, chaos, performance, rollback).

Output Template

Use references/python-edge-module-template.md to structure implementation proposals and reviews.

  1. Context and assumptions
  2. Module architecture
  3. Deployment and configuration
  4. Reliability, security, observability
  5. Validation and rollout plan

Guardrails

  • Do not recommend direct production rollout without pilot stage.
  • Do not embed secrets in Dockerfiles, source, or manifests.
  • Do not omit health probes, restart behavior, and rollback criteria.