Kestra Agent Skills

A curated collection of agent skills for operating Kestra environments.

Available skills

kestra-flow

Generate, modify, or debug Kestra Flow YAML grounded in the live flow schema — the same way the Kestra AI Copilot does.

Use when:

• Generating a new Kestra flow from a description
• Modifying or extending an existing flow
• Debugging invalid YAML or incorrect task/trigger references

Covers:

• Fetching the live flow schema from https://api.kestra.io/v1/plugins/schemas/flow
• Schema-validated task and trigger generation
• Partial modification (touch only the relevant part)
• Guardrails: no invented types, no hardcoded secrets, correct looping and trigger patterns

Skill path: skills/kestra-flow/SKILL.md

---

kestra-flow-hardening

Audit existing Kestra flows and add production-hardening controls — the consulting counterpart to kestra-flow.

Use when:

• Hardening one or more flows for production
• Auditing flows for resilience, idempotency, and guardrail gaps
• Adding retries, timeouts, error handling, concurrency limits, SLAs, or idempotency guards

Covers:

• Severity-ranked audit report (Critical / High / Medium / Low) with risk, caveat, and proposed fix per finding
• Idempotency judgment — never recommends a blind retry on a non-idempotent write; flags the dedup-guard vs. retry-if-safe branches
• Proportional auditing calibrated by flow signals (triggers, side-effects, namespace env); “already sound” is a valid result
• Surgical, schema-validated edits applied on confirmation, inline and structure-preserving
• Version- and edition-aware (OSS / EE), with EE-only patterns labeled and given an OSS fallback

Skill path: skills/kestra-flow-hardening/SKILL.md

---

kestra-ops

Operate Kestra using kestractl for flow, execution, namespace, and namespace-file operations.

Use when:

• Validating or deploying flows
• Triggering executions and checking status
• Managing namespaces and nsfiles
• Configuring or switching CLI contexts

Covers:

• Context and auth setup (config add, config use, config show)
• Read and inspection flows (flows list/get, executions get, namespaces list)
• Safe write operations (flows deploy, nsfiles upload/delete)
• Operational guardrails for production and automation output

Skill path: skills/kestra-ops/SKILL.md

---

migrate-kestra-2

Guide a full Kestra 1.3 → 2.0 migration: pre-flight audit, server upgrade, CLI-first flow migration, and guided rewrites of the patterns the CLI can’t automate.

Use when:

• Upgrading or migrating an instance to Kestra 2.0
• Checking whether an instance is ready for 2.0 (readiness report + complexity rating)
• Triaging kestra-migrate warnings or flows failing to parse after a 2.0 upgrade

Covers:

• Detect-first audit (probes CLIs, contexts, instance, runs kestra-migrate --check) with a shareable readiness report and Low/Medium/High/Critical complexity tier