airflow-adapter
Airflow adapter pattern for v2/v3 API compatibility. Use when working with adapters, version detection, or adding new API methods that need to work across Airflow 2.x and 3.x.
85
81%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
89%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 a solid, well-targeted skill description for a niche domain. It clearly states both what the skill does and when to use it, with good trigger terms that developers working with Airflow version compatibility would naturally use. The only minor weakness is that the 'what' portion could be slightly more specific about the concrete actions performed (e.g., creating adapter classes, wrapping API calls).
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Airflow adapter pattern, v2/v3 API compatibility) and some actions (version detection, adding new API methods), but doesn't list multiple concrete actions in detail—e.g., it doesn't specify what kinds of adapters or what specific operations are performed. | 2 / 3 |
Completeness | Clearly answers both 'what' (Airflow adapter pattern for v2/v3 API compatibility) and 'when' (explicit 'Use when working with adapters, version detection, or adding new API methods that need to work across Airflow 2.x and 3.x'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords a developer would use: 'Airflow', 'adapter', 'v2/v3', 'API compatibility', 'version detection', 'Airflow 2.x and 3.x'. These are terms a user working in this domain would naturally mention. | 3 / 3 |
Distinctiveness Conflict Risk | Highly specific niche—Airflow v2/v3 adapter compatibility is a very distinct domain. Unlikely to conflict with other skills unless there are multiple Airflow-related skills, and even then the adapter/version-compatibility focus is clear. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise overview skill that effectively points to related resources and provides a clear architectural picture. However, it falls short on actionability for its stated purpose of guiding implementation of new cross-version API methods—there's no concrete workflow or example for that task. The quick reference covers usage but not the development/extension workflow.
Suggestions
Add a brief step-by-step workflow for adding a new adapter method (e.g., 1. Add abstract method to base.py, 2. Implement in v2 adapter with v1 endpoint, 3. Implement in v3 adapter with v2 endpoint, 4. Verify both pass tests).
Include a concrete example of implementing a new method in both adapters showing the field/endpoint differences, or explicitly delegate this to patterns.md with a clear callout.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose. No unnecessary explanation of what Airflow is, what adapters are, or how APIs work. The architecture diagram, file listing, and code example are all lean and informative. | 3 / 3 |
Actionability | The quick reference shows executable code for using the adapter, but lacks guidance on how to add a new adapter method (which the skill description says it covers). There's no concrete example of implementing a new method across both versions. | 2 / 3 |
Workflow Clarity | The architecture flow is clear and the auto-detection is mentioned, but there's no step-by-step workflow for the stated use case of adding new API methods that work across versions. For a skill that covers adding new methods, a workflow with validation steps would be expected. | 2 / 3 |
Progressive Disclosure | Clean overview with well-signaled one-level-deep references to api-differences.md and patterns.md. Key files are listed with clear descriptions. Content is appropriately split between this overview and referenced files. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- astronomer/agents
- Commit
166c98a
- Reviewed
Table of Contents
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.