What are the 'Iron Laws' for Oban jobs?

The Iron Laws are essential best practices including ensuring jobs are idempotent, storing IDs instead of structs, handling all return values, and using string keys for arguments.

How does it handle rate limiting for external APIs?

It guides the configuration of specific queues with appropriate concurrency limits and recommends the use of dispatch_cooldown for external API interactions.

Can it help with testing background jobs?

Absolutely. It provides standardized patterns for using Oban.Testing to assert that jobs are enqueued correctly and to verify job performance using perform_job/2.

Why shouldn't I store structs in Oban job arguments?

Oban serializes arguments to JSON in the database. Storing structs can lead to serialization errors or stale data; it is best practice to store IDs and fetch fresh data inside the worker.

Does this skill support Oban Pro features?

Yes, it includes logic to detect Oban Pro and provides specific patterns for Pro workers, workflows, batches, and the Pro testing suite.

Oban Background Jobs for Elixir

Name: Oban Background Jobs for Elixir
Author: oliver-kriska

byoliver-kriska

•

API Development

Manages reliable background job processing and task scheduling for Elixir and Phoenix applications using Oban and Oban Pro.

This skill equips Claude with specialized knowledge for implementing and maintaining background job processing within Elixir and Phoenix environments. It enforces industry-standard 'Iron Laws,' such as ensuring job idempotency, avoiding struct serialization in favor of IDs, and utilizing string-key map matching for arguments. Whether working with standard Oban or the advanced Oban Pro, the skill provides patterns for worker creation, queue configuration, cron scheduling, and robust testing strategies to ensure high-performance asynchronous execution.

Key Features

01Provides optimized queue configuration for I/O, CPU, and API-bound tasks.

02Generates worker templates with built-in retry logic and unique constraints.

03Standardizes testing patterns using Oban.Testing and Oban.Pro.Testing.

04Enforces 'Iron Laws' for reliable, idempotent background job processing.

0562 GitHub stars

06Automatically detects and integrates Oban Pro features like Workflows and Batches.

Use Cases

01Implementing complex multi-step background workflows with Oban Pro Batches.

02Processing heavy data migrations and periodic maintenance tasks via cron scheduling.

03Building scalable email and notification systems with automatic retries and backoffs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oliver-kriska/claude-elixir-phoenix oban

For use in Claude.ai and ChatGPT

Download Skill