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

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/python-development/skills/async-python-patterns/SKILL.md

Quality

Content

75%Weight 40%Scale 1-5

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

A thorough, actionable skill body with executable code patterns and a clean reference split into details.md. Its main weakness is mild verbosity in the concept-explanation sections that assume too little of Claude's prior knowledge.

Suggestions

Trim the 'Core Concepts' prose (e.g., the event loop and coroutines explanations) to assume Claude's competence and save tokens, keeping only what is non-obvious.

Add an explicit one-line mapping of which advanced topics live in references/details.md (e.g., 'Async context managers, semaphores, queues — see details.md') so navigation is unambiguous.

Consider moving the longer Pattern code blocks that duplicate common knowledge into the details reference, keeping SKILL.md focused on the decision guide and key examples.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with executable, well-targeted code, but includes concept prose Claude already knows (e.g., 'The event loop is the heart of asyncio, managing and scheduling asynchronous tasks') that could be trimmed, matching the 'mostly efficient but some unnecessary explanation' anchor.	3 / 5
Actionability	Provides fully executable, copy-paste-ready code across multiple patterns (gather, create_task, wait_for, cancellation) with specific examples covering the common cases, matching the 'fully executable' anchor.	5 / 5
Workflow Clarity	Clear sequencing via a sync-vs-async decision table, numbered patterns, and a dedicated pitfalls section; this is reference material rather than a destructive multi-step workflow, so explicit validation checkpoints are not strictly required, keeping it at 4 rather than 5.	4 / 5
Progressive Disclosure	Good structure with a body that acts as an overview and a clearly signaled one-level-deep reference ('Detailed sections ... live in references/details.md. Read that file ...') pointing to a real bundle file; minor gaps in explicit section-to-reference mapping keep it just below 5.	4 / 5
	Total	16 / 20 Passed

Description

83%Weight 40%Scale 1-5

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

A strong, well-structured description that clearly states capabilities and provides an explicit 'Use when' trigger. It is distinctive and actionable, with only minor room to add synonym/extension-based trigger terms.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete capabilities ('asyncio, concurrent programming, and async/await patterns', 'async APIs, concurrent systems, I/O-bound applications'), with only minor coverage gaps, matching the 'lists several specific actions' anchor rather than the fully comprehensive 5.	4 / 5
Completeness	Explicitly answers both 'what' ('Master Python asyncio, concurrent programming, and async/await patterns') and 'when' with a concrete 'Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations' trigger clause.	5 / 5
Trigger Term Quality	Includes natural terms users would say ('async APIs', 'concurrent systems', 'I/O-bound applications', 'non-blocking operations', 'async/await') with good coverage, though it lacks synonyms or file/extension variants that would push it to 5.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Python async/concurrency) with distinct triggers and minimal overlap risk; falls just short of 5 because the domain is somewhat broad and could marginally overlap with general Python or concurrency skills.	4 / 5
	Total	17 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: wshobson/agents
Path: plugins/python-development/skills/async-python-patterns/SKILL.md
Commit: d6837ae

Reviewed: about 13 hours 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.