airflow-plugins

Build Airflow 3.1+ plugins that embed FastAPI apps, custom UI pages, React components, middleware, macros, and operator links directly into the Airflow UI. Use this skill whenever the user wants to create an Airflow plugin, add a custom UI page or nav entry to Airflow, build FastAPI-backed endpoints inside Airflow, serve static assets from a plugin, embed a React app in the Airflow UI, add middleware to the Airflow API server, create custom operator extra links, or call the Airflow REST API from inside a plugin. Also trigger when the user mentions AirflowPlugin, fastapi_apps, external_views, react_apps, plugin registration, or embedding a web app in Airflow 3.1+. If someone is building anything custom inside Airflow 3.1+ that involves Python and a browser-facing interface, this skill almost certainly applies.

Quality

88%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that thoroughly covers specific capabilities, provides rich trigger terms, explicitly addresses both what and when, and occupies a clearly distinct niche. The description is comprehensive without being padded with fluff—every phrase serves to either describe a capability or provide a trigger condition. The only minor concern is length, but the detail is warranted given the breadth of the skill's scope.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: build plugins embedding FastAPI apps, custom UI pages, React components, middleware, macros, operator links. Very detailed enumeration of capabilities.	3 / 3
Completeness	Clearly answers both 'what' (build Airflow 3.1+ plugins with FastAPI apps, UI pages, React components, middleware, macros, operator links) and 'when' with explicit 'Use this skill whenever...' and 'Also trigger when...' clauses providing comprehensive trigger guidance.	3 / 3
Trigger Term Quality	Excellent coverage of natural trigger terms including 'Airflow plugin', 'custom UI page', 'FastAPI-backed endpoints', 'React app', 'AirflowPlugin', 'fastapi_apps', 'external_views', 'react_apps', 'operator extra links', 'REST API', and 'Airflow 3.1+'. These are terms users would naturally use.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with a clear niche: Airflow 3.1+ plugin development specifically for UI/web-facing features. The version specificity (3.1+), domain (Airflow plugins), and specific class names (AirflowPlugin, fastapi_apps) make it very unlikely to conflict with other skills.	3 / 3
	Total	12 / 12 Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality, highly actionable skill with excellent executable code examples and clear workflow sequencing. Its main weakness is length — it serves as both a quick-start guide and a comprehensive reference, which makes it token-heavy for the context window. The critical warnings, verification checklist, and pitfalls table are strong additions that prevent common mistakes.

Suggestions

Split detailed sections (JWT token management, common API endpoint patterns, other component types) into separate reference files and link to them from the main SKILL.md to improve progressive disclosure and reduce token usage.

Trim the streaming proxy example and direct database access section — these are edge cases that could live in a supplementary file, saving ~60 lines in the main skill.

Dimension	Reasoning	Score
Conciseness	The skill is comprehensive and mostly efficient, but includes some sections that could be tightened — e.g., the JWT token management block is very detailed with double-checked locking explanation, the direct database access section includes a lengthy warning, and some patterns (like the streaming proxy) may not be needed in a core skill file. However, it avoids explaining basic concepts Claude already knows.	2 / 3
Actionability	Excellent actionability throughout — every section provides fully executable, copy-paste-ready Python code with correct imports, concrete FastAPI route definitions, HTML examples, CLI commands, and even verification steps. The SDK call patterns, JWT management, and endpoint examples are all complete and runnable.	3 / 3
Workflow Clarity	The skill follows a clear numbered step sequence (Steps 1-7) with explicit validation checkpoints — the 'Before writing any code, verify' checklist at the top, the pitfalls table at the bottom, and verification instructions ('Verify the plugin loaded: open Admin > Plugins'). The conditional skip guidance ('skip to Step 5 or Step 6') and restart requirements are clearly called out.	3 / 3
Progressive Disclosure	The content is well-structured with clear headers and a logical progression, but it's quite long (~400+ lines) and could benefit from splitting detailed sections (JWT management, common API patterns, other component types) into separate reference files. The external references at the bottom are good, but the main file tries to be both overview and comprehensive reference simultaneously.	2 / 3
	Total	10 / 12 Passed

Validation

90%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (592 lines); consider splitting into references/ and linking	Warning

	Total	10 / 11 Passed

Repository: astronomer/agents
Commit: 0642adb

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.