async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

Quality

62%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agent/skills/async-python-patterns/SKILL.md

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 well-structured description with explicit 'Use when' guidance and good trigger term coverage for async Python development. The main weakness is the somewhat vague capability description - 'Master' is aspirational rather than action-oriented, and specific operations (event loops, coroutines, async generators) are not enumerated.

Suggestions

Replace 'Master' with specific concrete actions like 'Implement coroutines, manage event loops, handle async context managers, and coordinate concurrent tasks'

Add more specific file/pattern triggers like '.py files with async def', 'aiohttp', 'asyncio.gather'

Dimension	Reasoning	Score
Specificity	Names the domain (Python asyncio, concurrent programming) and mentions some actions (building async APIs, concurrent systems), but lacks specific concrete actions like 'implement coroutines', 'manage event loops', or 'handle async context managers'.	2 / 3
Completeness	Clearly answers both what ('Master Python asyncio, concurrent programming, and async/await patterns') and when ('Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations') with explicit trigger guidance.	3 / 3
Trigger Term Quality	Good coverage of natural terms users would say: 'asyncio', 'async/await', 'concurrent', 'async APIs', 'I/O-bound', 'non-blocking'. These are terms developers naturally use when seeking help with async Python.	3 / 3
Distinctiveness Conflict Risk	Clear niche focused specifically on Python async programming with distinct triggers like 'asyncio', 'async/await', 'non-blocking'. Unlikely to conflict with general Python skills or other language concurrency skills.	3 / 3
	Total	11 / 12 Passed

Implementation

35%

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

This skill functions primarily as a table of contents rather than actionable guidance. It lacks any concrete code examples, executable patterns, or copy-paste ready snippets for async Python. The content over-relies on external resources without providing sufficient standalone value in the main skill file.

Suggestions

Add a Quick Start section with at least one executable async/await code example (e.g., basic asyncio.gather pattern or async context manager)

Replace abstract instructions like 'Pick concurrency patterns' with concrete guidance showing when to use asyncio.gather vs TaskGroup vs Queue with brief code snippets

Include a minimal working example of error handling with asyncio.timeout or asyncio.wait_for that can be copied directly

Remove or significantly condense the 'Use this skill when' and 'Do not use this skill when' sections as these are obvious to Claude

Dimension	Reasoning	Score
Conciseness	The skill is relatively brief but includes some unnecessary sections like 'Use this skill when' and 'Do not use this skill when' lists that explain obvious use cases Claude would already understand. The actual instructions are lean but the surrounding context adds padding.	2 / 3
Actionability	The skill provides no concrete code examples, commands, or executable guidance. Instructions are entirely abstract ('Pick concurrency patterns', 'Add timeouts') without showing how to implement any of these patterns. Everything is deferred to an external resource.	1 / 3
Workflow Clarity	The instructions section provides a rough sequence of steps (clarify, pick patterns, add handling, include testing), but lacks any validation checkpoints, concrete examples of what each step produces, or feedback loops for error recovery.	2 / 3
Progressive Disclosure	References to external resources are present and one-level deep, but the main skill file is too sparse - it's essentially just a pointer to implementation-playbook.md without providing any standalone value or quick-start content.	2 / 3
	Total	7 / 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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: Dokhacgiakhoa/antigravity-ide
Commit: 332e58b

Reviewed: 17 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.