yourls-airflow-integration

Automates YOURLS URL shortening integration into Airflow DAGs with async aiohttp client and graceful fallback to original URLs on failure.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mporenta/airflow --skill yourls-airflow-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yourls-airflow-integration
Source: https://github.com/mporenta/airflow/tree/main/.claude/skills/yourls-airflow-integration
Command: npx skills add https://github.com/mporenta/airflow --skill yourls-airflow-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrating URL shortening into Airflow pipelines can be error-prone and hard to audit; this Skill provides a structured approach to generate, track, and reuse short URLs within DAGs and notifications.

Core Features & Use Cases

  • Async YOURLS client creation with aiohttp
  • Airflow connection setup for YOURLS API
  • Configuration patterns for timeouts, retries, and concurrency
  • Graceful fallback to original URLs on YOURLS failure
  • Idempotent short URL generation for stable tracking
  • Unit testing templates and examples for reliability

Quick Start

Use when adding URL shortening to SMS, email, or notification pipelines, or when user mentions YOURLS, short URLs, or link tracking.

Frequently Asked Questions about yourls-airflow-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate YOURLS URL shortening into Airflow DAGs?

Integrate YOURLS URL shortening into Airflow by using an async aiohttp client configured with Airflow credentials to generate trackable short URLs within your DAGs and notification workflows.

Can I use an async YOURLS client with Airflow for URL shortening?

Yes, an async YOURLS client using aiohttp can be used with Airflow. It supports configurable timeouts, retries, and concurrency for generating short URLs in your pipelines.

What happens when YOURLS URL shortening fails in an Airflow pipeline?

When YOURLS URL shortening fails in an Airflow pipeline, the integration provides graceful fallback to the original URL, ensuring notification workflows continue without breaking.

How do I ensure idempotent short URL generation in Airflow?

Idempotent short URL generation in Airflow ensures stable tracking by reusing generated keywords, preventing duplicate entries when DAGs retry or rerun tasks.

Does this Airflow YOURLS integration support credentials setup?

Yes, the integration uses Airflow connection setup to securely manage YOURLS API credentials, allowing DAGs to authenticate and generate short URLs without hardcoded secrets.

Are there unit test templates for Airflow YOURLS URL shortening?

Yes, the integration includes unit testing templates and examples to verify the reliability of your YOURLS client, async operations, and fallback logic in Airflow.