aiskillstore/marketplace / skills/0xdarkmatter/python-async-patterns
python-async-patterns
VerifiedPython asyncio patterns for concurrent programming. Triggers on: asyncio, async, await, coroutine, gather, semaphore, TaskGroup, event loop, aiohttp, concurrent.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
| assets/async-project-template.py | script | 3.6 KB |
| references/aiohttp-patterns.md | markdown | 6.1 KB |
| references/concurrency-patterns.md | markdown | 6.0 KB |
| references/debugging-async.md | markdown | 5.8 KB |
| references/error-handling.md | markdown | 11.9 KB |
| references/mixing-sync-async.md | markdown | 5.7 KB |
| references/performance.md | markdown | 10.1 KB |
| references/production-patterns.md | markdown | 10.0 KB |
| scripts/find-blocking-calls.sh | script | 1.4 KB |
| skill-report.json | config | 51.9 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-06T01:54:50.770Z",
"slug": "0xdarkmatter-python-async-patterns",
"source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/python-async-patterns",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "2046b512720ba3f4bfc3b901554ae2098fd560b8830dd2dec26720797de38a5c",
"tree_hash": "44f71cf82d293bece54ed31e3df40c6c0e2f7e46d4ba063203f07018dc8a3327",
"provenance": {
"model_requested": "gpt-5.5:high",
"model_effective": "codex:gpt-5.5:high",
"fallback_chain": [
{
"agent": "codex",
"model": "gpt-5.5",
"effort": "high",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "python-async-patterns",
"description": "Guides Python developers through asyncio concurrency, aiohttp, task management, error handling, and production async service patterns.",
"summary": "Reusable asyncio patterns for robust concurrent Python applications.",
"icon": "📦",
"version": "1.0.0",
"author": "0xDarkMatter",
"license": "MIT",
"tags": [
"python",
"asyncio",
"aiohttp",
"concurrency",
"task-management"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"network",
"filesystem",
"external_commands"
],
"category": "coding"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "AI review found the static alerts are documentation examples or benign utility references. Network and file operations appear in asyncio teaching materials and templates; the shell script only scans local code. No prompt injection or malicious intent was found.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "network",
"evidence": [
{
"file": "assets/async-project-template.py",
"line_start": 71,
"line_end": 71
},
{
"file": "assets/async-project-template.py",
"line_start": 94,
"line_end": 94
},
{
"file": "assets/async-project-template.py",
"line_start": 126,
"line_end": 126
},
{
"file": "assets/async-project-template.py",
"line_start": 127,
"line_end": 127
},
{
"file": "references/concurrency-patterns.md",
"line_start": 228,
"line_end": 228
},
{
"file": "references/error-handling.md",
"line_start": 64,
"line_end": 64
},
{
"file": "references/error-handling.md",
"line_start": 234,
"line_end": 234
},
{
"file": "references/error-handling.md",
"line_start": 267,
"line_end": 267
},
{
"file": "references/mixing-sync-async.md",
"line_start": 252,
"line_end": 252
},
{
"file": "SKILL.md",
"line_start": 20,
"line_end": 20
},
{
"file": "SKILL.md",
"line_start": 27,
"line_end": 27
},
{
"file": "SKILL.md",
"line_start": 47,
"line_end": 47
},
{
"file": "SKILL.md",
"line_start": 86,
"line_end": 86
},
{
"file": "SKILL.md",
"line_start": 27,
"line_end": 27
}
]
},
{
"factor": "filesystem",
"evidence": [
{
"file": "references/aiohttp-patterns.md",
"line_start": 169,
"line_end": 169
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "scripts/find-blocking-calls.sh",
"line_start": 1,
"line_end": 1
},
{
"file": "SKILL.md",
"line_start": 16,
"line_end": 31
},
{
"file": "SKILL.md",
"line_start": 31,
"line_end": 35
},
{
"file": "SKILL.md",
"line_start": 35,
"line_end": 41
},
{
"file": "SKILL.md",
"line_start": 41,
"line_end": 45
},
{
"file": "SKILL.md",
"line_start": 45,
"line_end": 55
},
{
"file": "SKILL.md",
"line_start": 55,
"line_end": 59
},
{
"file": "SKILL.md",
"line_start": 59,
"line_end": 66
},
{
"file": "SKILL.md",
"line_start": 66,
"line_end": 70
},
{
"file": "SKILL.md",
"line_start": 70,
"line_end": 78
},
{
"file": "SKILL.md",
"line_start": 78,
"line_end": 82
},
{
"file": "SKILL.md",
"line_start": 82,
"line_end": 93
},
{
"file": "SKILL.md",
"line_start": 93,
"line_end": 95
},
{
"file": "SKILL.md",
"line_start": 95,
"line_end": 104
},
{
"file": "SKILL.md",
"line_start": 104,
"line_end": 110
},
{
"file": "SKILL.md",
"line_start": 110,
"line_end": 111
},
{
"file": "SKILL.md",
"line_start": 111,
"line_end": 112
},
{
"file": "SKILL.md",
"line_start": 112,
"line_end": 113
},
{
"file": "SKILL.md",
"line_start": 113,
"line_end": 114
},
{
"file": "SKILL.md",
"line_start": 114,
"line_end": 115
},
{
"file": "SKILL.md",
"line_start": 115,
"line_end": 119
},
{
"file": "SKILL.md",
"line_start": 119,
"line_end": 129
},
{
"file": "SKILL.md",
"line_start": 129,
"line_end": 134
},
{
"file": "SKILL.md",
"line_start": 134,
"line_end": 135
},
{
"file": "SKILL.md",
"line_start": 135,
"line_end": 136
},
{
"file": "SKILL.md",
"line_start": 136,
"line_end": 137
},
{
"file": "SKILL.md",
"line_start": 137,
"line_end": 138
},
{
"file": "SKILL.md",
"line_start": 138,
"line_end": 139
},
{
"file": "SKILL.md",
"line_start": 139,
"line_end": 140
},
{
"file": "SKILL.md",
"line_start": 140,
"line_end": 144
},
{
"file": "SKILL.md",
"line_start": 144,
"line_end": 148
},
{
"file": "SKILL.md",
"line_start": 148,
"line_end": 155
},
{
"file": "SKILL.md",
"line_start": 155,
"line_end": 158
},
{
"file": "SKILL.md",
"line_start": 158,
"line_end": 159
},
{
"file": "SKILL.md",
"line_start": 159,
"line_end": 160
}
]
}
],
"static_findings": [
{
"id": "network:assets/async-project-template.py:71:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "assets/async-project-template.py",
"line_start": 71,
"line_end": 71,
"snippet": "async def fetch(self, url: str) -> dict[str, Any] | None:"
},
{
"id": "network:assets/async-project-template.py:94:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "assets/async-project-template.py",
"line_start": 94,
"line_end": 94,
"snippet": "return await self.fetch(url)"
},
{
"id": "network:assets/async-project-template.py:126:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "assets/async-project-template.py",
"line_start": 126,
"line_end": 126,
"snippet": "\"https://httpbin.org/json\","
},
{
"id": "network:assets/async-project-template.py:127:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "assets/async-project-template.py",
"line_start": 127,
"line_end": 127,
"snippet": "\"https://httpbin.org/uuid\","
},
{
"id": "filesystem:references/aiohttp-patterns.md:169:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "references/aiohttp-patterns.md",
"line_start": 169,
"line_end": 169,
"snippet": "with open(dest_path, 'wb') as f:"
},
{
"id": "network:references/concurrency-patterns.md:228:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "references/concurrency-patterns.md",
"line_start": 228,
"line_end": 228,
"snippet": "tasks = [asyncio.create_task(fetch(url)) for url in urls]"
},
{
"id": "network:references/error-handling.md:64:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "references/error-handling.md",
"line_start": 64,
"line_end": 64,
"snippet": "lambda: fetch(url),"
},
{
"id": "network:references/error-handling.md:234:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "references/error-handling.md",
"line_start": 234,
"line_end": 234,
"snippet": "*[fetch(url) for url in urls],"
},
{
"id": "network:references/error-handling.md:267:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "references/error-handling.md",
"line_start": 267,
"line_end": 267,
"snippet": "data = await fetch(url)"
},
{
"id": "network:references/mixing-sync-async.md:252:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "references/mixing-sync-async.md",
"line_start": 252,
"line_end": 252,
"snippet": "rows = await conn.fetch(\"SELECT * FROM users\")"
},
{
"id": "sensitive:references/mixing-sync-async.md:244:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "references/mixing-sync-async.md",
"line_start": 244,
"line_end": 244,
"snippet": "async with aiosqlite.connect(\"db.sqlite\") as db:"
},
{
"id": "blocker:references/performance.md:302:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/performance.md",
"line_start": 302,
"line_end": 302,
"snippet": "# Process in chunks to avoid memory issues with huge lists"
},
{
"id": "sensitive:references/production-patterns.md:110:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "references/production-patterns.md",
"line_start": 110,
"line_end": 110,
"snippet": "app.state.db = await create_db_pool()"
},
{
"id": "sensitive:references/production-patterns.md:113:sqlite-database-file",
"category": "sensitive",
"severity": "medium",
"pattern": "SQLite database file",
"file": "references/production-patterns.md",
"line_start": 113,
"line_end": 113,
"snippet": "await app.state.db.close()"
},
{
"id": "external_commands:scripts/find-blocking-calls.sh:1:unix-shell-invocation",
"category": "external_commands",
"severity": "medium",
"pattern": "Unix shell invocation",
"file": "scripts/find-blocking-calls.sh",
"line_start": 1,
"line_end": 1,
"snippet": "#!/bin/bash"
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 16,
"line_end": 31,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 31,
"line_end": 35,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 35,
"line_end": 41,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 41,
"line_end": 45,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 45,
"line_end": 55,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 55,
"line_end": 59,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 59,
"line_end": 66,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 66,
"line_end": 70,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 70,
"line_end": 78,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 78,
"line_end": 82,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 82,
"line_end": 93,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 93,
"line_end": 95,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 95,
"line_end": 104,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:104:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 104,
"line_end": 110,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 110,
"line_end": 111,
"snippet": "| `gather(*tasks)` | Multiple independent operations |"
},
{
"id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 111,
"line_end": 112,
"snippet": "| `Semaphore(n)` | Rate limiting, resource constraints |"
},
{
"id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 112,
"line_end": 113,
"snippet": "| `TaskGroup()` | Structured concurrency (3.11+) |"
},
{
"id": "external_commands:SKILL.md:113:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 113,
"line_end": 114,
"snippet": "| `Queue()` | Producer-consumer |"
},
{
"id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 114,
"line_end": 115,
"snippet": "| `timeout(s)` | Timeout wrapper (3.11+) |"
},
{
"id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 115,
"line_end": 119,
"snippet": "| `Lock()` | Shared mutable state |"
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 119,
"line_end": 129,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 129,
"line_end": 134,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 134,
"line_end": 135,
"snippet": "- `./references/concurrency-patterns.md` - Queue, Lock, producer-consumer"
},
{
"id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 135,
"line_end": 136,
"snippet": "- `./references/aiohttp-patterns.md` - HTTP client/server patterns"
},
{
"id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 136,
"line_end": 137,
"snippet": "- `./references/mixing-sync-async.md` - run_in_executor, thread pools"
},
{
"id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 137,
"line_end": 138,
"snippet": "- `./references/debugging-async.md` - Debug mode, profiling, finding issues"
},
{
"id": "external_commands:SKILL.md:138:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 138,
"line_end": 139,
"snippet": "- `./references/production-patterns.md` - Graceful shutdown, health checks, signal handling"
},
{
"id": "external_commands:SKILL.md:139:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 139,
"line_end": 140,
"snippet": "- `./references/error-handling.md` - Retry with backoff, circuit breakers, partial failures"
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 140,
"line_end": 144,
"snippet": "- `./references/performance.md` - uvloop, connection pooling, buffer sizing"
},
{
"id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 144,
"line_end": 148,
"snippet": "- `./scripts/find-blocking-calls.sh` - Scan code for blocking calls in async functions"
},
{
"id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 148,
"line_end": 155,
"snippet": "- `./assets/async-project-template.py` - Production-ready async app skeleton"
},
{
"id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 155,
"line_end": 158,
"snippet": "- `python-typing-patterns` - Type hints for async functions"
},
{
"id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 158,
"line_end": 159,
"snippet": "- `python-fastapi-patterns` - Async web APIs"
},
{
"id": "external_commands:SKILL.md:159:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 159,
"line_end": 160,
"snippet": "- `python-observability-patterns` - Async logging and tracing"
},
{
"id": "network:SKILL.md:20:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "SKILL.md",
"line_start": 20,
"line_end": 20,
"snippet": "async def fetch(url: str) -> str:"
},
{
"id": "network:SKILL.md:27:fetch-api-call",
"category": "network",
"severity": "low",
"pattern": "Fetch API call",
"file": "SKILL.md",
"line_start": 27,
"line_end": 27,
"snippet": "result = await fetch(\"https://example.com\")"
},
{
"id": "network:SKILL.md:47:python-http-libraries",
"category": "network",
"severity": "low",
"pattern": "Python HTTP libraries",
"file": "SKILL.md",
"line_start": 47,
"line_end": 47,
"snippet": "\"\"\"Limit concurrent requests.\"\"\""
},
{
"id": "network:SKILL.md:86:python-http-libraries",
"category": "network",
"severity": "low",
"pattern": "Python HTTP libraries",
"file": "SKILL.md",
"line_start": 86,
"line_end": 86,
"snippet": "requests.get(url) # Blocking I/O!"
},
{
"id": "network:SKILL.md:27:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 27,
"line_end": 27,
"snippet": "result = await fetch(\"https://example.com\")"
}
],
"finding_verdicts": [
{
"id": "network:assets/async-project-template.py:71:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is a reusable aiohttp example method that fetches caller-provided URLs; it does not hide an endpoint or send secrets. Network access is expected for an async HTTP template."
},
{
"id": "network:assets/async-project-template.py:94:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This call delegates to the documented fetch helper inside bounded concurrency example code. It has no hidden destination, secret handling, or automatic exfiltration behavior."
},
{
"id": "network:assets/async-project-template.py:126:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The URL points to a public httpbin demo endpoint inside a sample main block. No user data or credentials are transmitted by this example."
},
{
"id": "network:assets/async-project-template.py:127:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The URL points to a public httpbin demo endpoint inside a sample main block. No user data or credentials are transmitted by this example."
},
{
"id": "filesystem:references/aiohttp-patterns.md:169:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.84,
"reason": "The open call is in a documented file-download example writing response chunks to a caller-provided destination. It is not executed by the skill and no covert file access is present."
},
{
"id": "network:references/concurrency-patterns.md:228:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is documentation for returning the first successful response from input URLs. It does not define hidden destinations or collect sensitive data."
},
{
"id": "network:references/error-handling.md:64:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is a retry example that wraps a caller-supplied fetch operation. It documents error handling and does not introduce hidden network destinations."
},
{
"id": "network:references/error-handling.md:234:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This is documentation for collecting successes and failures across caller-supplied URLs. It does not transmit secrets or contact an unexpected endpoint."
},
{
"id": "network:references/error-handling.md:267:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "This line wraps a caller-supplied fetch in a structured result object. It is educational sample code and has no hidden data flow."
},
{
"id": "network:references/mixing-sync-async.md:252:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.92,
"reason": "conn.fetch is an async database API call in a database access example, not a web fetch. The example uses a placeholder connection and shows no credential exfiltration."
},
{
"id": "sensitive:references/mixing-sync-async.md:244:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "db.sqlite is a placeholder local SQLite file in an async database access example. There is no secret material or automatic file read."
},
{
"id": "blocker:references/performance.md:302:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Line 302 is a comment about chunking large lists to avoid memory issues. It is not reconnaissance or system enumeration."
},
{
"id": "sensitive:references/production-patterns.md:110:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "app.state.db is a FastAPI lifecycle handle returned by create_db_pool. No SQLite file path or sensitive credential appears on this line."
},
{
"id": "sensitive:references/production-patterns.md:113:sqlite-database-file",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "This closes the FastAPI database handle during shutdown. It does not expose a SQLite file, credential, or sensitive data."
},
{
"id": "external_commands:scripts/find-blocking-calls.sh:1:unix-shell-invocation",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "The shell script is a local developer utility that runs ripgrep with quoted arguments to report blocking calls. It does not eval input, modify files, or send data externally."
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:104:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is inline Markdown formatting in a quick-reference table, not command execution. It documents asyncio APIs and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is inline Markdown formatting in a quick-reference table, not command execution. It documents asyncio APIs and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is inline Markdown formatting in a quick-reference table, not command execution. It documents asyncio APIs and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:113:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is inline Markdown formatting in a quick-reference table, not command execution. It documents asyncio APIs and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is inline Markdown formatting in a quick-reference table, not command execution. It documents asyncio APIs and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is inline Markdown formatting in a quick-reference table, not command execution. It documents asyncio APIs and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "This is a Markdown code fence in documentation, not Ruby code or shell execution. The skill presents examples and does not execute SKILL.md content."
},
{
"id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:138:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:139:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a Markdown bullet referencing a local helper script, not automatic execution. The script must be run intentionally by the user."
},
{
"id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "external_commands:SKILL.md:159:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This is inline Markdown formatting for references or related skill names, not Ruby or shell execution. No executable command is present in SKILL.md."
},
{
"id": "network:SKILL.md:20:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "SKILL.md shows a minimal aiohttp example fetching a caller-provided URL. It is documentation only and does not transmit secrets."
},
{
"id": "network:SKILL.md:27:fetch-api-call",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The example fetches example.com in a basic asyncio demonstration. This is documentation and no sensitive data is sent."
},
{
"id": "network:SKILL.md:47:python-http-libraries",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The text is a docstring about concurrency limits, not a HTTP library import or request. No network operation is present on this line."
},
{
"id": "network:SKILL.md:86:python-http-libraries",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "requests.get appears in a warning that labels it as wrong because it blocks the event loop. It is educational content, not code the skill runs."
},
{
"id": "network:SKILL.md:27:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The hardcoded URL is example.com in a minimal teaching snippet. It is not a hidden endpoint and does not receive user data or credentials."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 10,
"total_lines": 2654,
"audit_model": "codex",
"audited_at": "2026-07-06T01:54:50.770Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Build Reliable Async Python",
"value_statement": "Async Python code often fails due to blocking calls, unbounded tasks, and weak cleanup. This skill provides reusable asyncio patterns, examples, and references for robust concurrent services.",
"seo_keywords": [
"Python asyncio",
"async Python patterns",
"aiohttp",
"TaskGroup",
"concurrency",
"Codex",
"Claude",
"Claude Code",
"async error handling",
"Python performance"
],
"actual_capabilities": [
"Provides asyncio examples for gather, semaphores, TaskGroup, timeouts, and async context managers.",
"Documents aiohttp client patterns, file transfer, WebSocket use, retries, and bounded requests.",
"Explains retry backoff, circuit breakers, partial failure handling, and structured result objects.",
"Shows production lifecycle patterns for shutdown, health checks, connection pools, and signal handling.",
"Includes a shell script that reports blocking calls in local Python files.",
"Includes an async project template with aiohttp session management and graceful cleanup."
],
"limitations": [
"It does not execute or validate generated code automatically.",
"Examples may need changes for specific Python versions, frameworks, and deployment rules.",
"The shell script requires ripgrep and scans local files only.",
"Network examples use demo URLs and should be replaced before production use."
],
"use_cases": [
{
"title": "Refactor Blocking Coroutines",
"description": "Find blocking calls, missing awaits, and task management issues in async Python services.",
"target_user": "Backend developers"
},
{
"title": "Design Concurrent HTTP Clients",
"description": "Plan aiohttp clients with bounded concurrency, retries, timeouts, and structured responses.",
"target_user": "API integration engineers"
},
{
"title": "Prepare Async Code For Production",
"description": "Add shutdown handling, health checks, resource cleanup, and safer failure behavior.",
"target_user": "Platform engineers"
}
],
"prompt_templates": [
{
"title": "Choose An Async Pattern",
"scenario": "Beginner guidance for a new async task.",
"prompt": "Explain the asyncio pattern I should use for this task: [describe task]. Include risks around blocking calls and cleanup."
},
{
"title": "Review A Coroutine",
"scenario": "Intermediate review of an existing function.",
"prompt": "Review this async Python function for blocking calls, orphaned tasks, missing timeouts, and cancellation problems: [paste function]."
},
{
"title": "Design HTTP Concurrency",
"scenario": "Advanced planning for external API calls.",
"prompt": "Design an aiohttp client flow for these endpoints: [list]. Include bounded concurrency, retries, timeouts, and result handling."
},
{
"title": "Plan Production Async Service",
"scenario": "Advanced architecture for deployed async systems.",
"prompt": "Plan a production async service architecture for [service]. Cover lifecycle management, health checks, shutdown, backpressure, and observability."
}
],
"output_examples": [
{
"input": "Audit an async scraper that slows down under load.",
"output": [
"Identifies unbounded concurrency as the likely cause.",
"Recommends semaphore limits, connection pooling, and per-request timeouts.",
"Lists tests for cancellation, retries, and partial failures."
]
},
{
"input": "Design a background worker for API calls.",
"output": [
"Proposes a queue based worker model with bounded throughput.",
"Adds retry backoff, shutdown handling, and tracked task cleanup.",
"Calls out metrics for failures, latency, and queue depth."
]
},
{
"input": "Explain why a coroutine blocks the event loop.",
"output": [
"Shows which operations are synchronous and why they block progress.",
"Suggests async libraries or executor isolation for those operations.",
"Highlights where timeouts and cancellation handling are missing."
]
}
],
"best_practices": [
"Set explicit timeouts on network and background operations.",
"Bound concurrency with semaphores, queues, or worker pools.",
"Track created tasks and shut them down during application cleanup."
],
"anti_patterns": [
"Do not call blocking I/O directly inside coroutines.",
"Do not create fire-and-forget tasks without references.",
"Do not gather unlimited work without backpressure."
],
"faq": [
{
"question": "What Python versions does this skill target?",
"answer": "It recommends Python 3.10+. Some examples use Python 3.11 features, such as TaskGroup and timeout."
},
{
"question": "Does it include runnable files?",
"answer": "Yes. It includes an async project template and a shell script for finding blocking calls."
},
{
"question": "Can it help with aiohttp?",
"answer": "Yes. It covers client sessions, retries, file transfer, WebSocket use, and bounded request patterns."
},
{
"question": "Does it replace testing?",
"answer": "No. You still need unit, integration, cancellation, and load tests for your application."
},
{
"question": "Can Claude or Codex use this skill?",
"answer": "Yes. It is marked for Claude, Codex, and Claude Code workflows."
},
{
"question": "Does the skill make network requests automatically?",
"answer": "No. Network calls appear in examples and templates that a user must run or adapt."
}
]
},
"file_structure": [
{
"name": "assets",
"type": "dir",
"path": "assets",
"children": [
{
"name": "async-project-template.py",
"type": "file",
"path": "assets/async-project-template.py",
"lines": 140
}
]
},
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "aiohttp-patterns.md",
"type": "file",
"path": "references/aiohttp-patterns.md",
"lines": 260
},
{
"name": "concurrency-patterns.md",
"type": "file",
"path": "references/concurrency-patterns.md",
"lines": 278
},
{
"name": "debugging-async.md",
"type": "file",
"path": "references/debugging-async.md",
"lines": 302
},
{
"name": "error-handling.md",
"type": "file",
"path": "references/error-handling.md",
"lines": 427
},
{
"name": "mixing-sync-async.md",
"type": "file",
"path": "references/mixing-sync-async.md",
"lines": 272
},
{
"name": "performance.md",
"type": "file",
"path": "references/performance.md",
"lines": 396
},
{
"name": "production-patterns.md",
"type": "file",
"path": "references/production-patterns.md",
"lines": 371
}
]
},
{
"name": "scripts",
"type": "dir",
"path": "scripts",
"children": [
{
"name": "find-blocking-calls.sh",
"type": "file",
"path": "scripts/find-blocking-calls.sh",
"lines": 47
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 161
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |