python-notebooks-async skill
✓ DoğrulandıAjanların, event loop çakışmalarını önlemek için Jupyter notebook'ları veya hücre tabanlı iş akışları içinde asyncio kodu yazmalarına ve incelemelerine yardımcı olur.
- GitHub yıldızları
- 6
- Dosyalar
- 2
- Son commit
- 29 Eki 2026
- Lisans
- CC0-1.0
- İzin verilen araçlar
- —
python-notebooks-async skill ne işe yarar?
python-notebooks-async bir agent skill'dir. Ajanların, event loop çakışmalarını önlemek için Jupyter notebook'ları veya hücre tabanlı iş akışları içinde asyncio kodu yazmalarına ve incelemelerine yardımcı olur.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
python-notebooks-async skilli hakkında
Jupyter notebook'ları veya hücre tabanlı iş akışları üzerinde çalışan geliştiriciler, bu SKILL sayesinde event loop çakışmalarını tetiklemeden asenkron Python kodlarını yönetebilirler. Bu yetenek, notebook kernel'ının halihazırda event loop'u yönettiği ortamlarda asenkron script'ler yazmak, incelemek veya taşımakla görevli ajanlar için rehberlik sağlar. Ajanlar bu desenleri takip ederek, asyncio.run() kullanımında karşılaşılan RuntimeError gibi yaygın hatalardan veya sessizce başarısız olan görevlerden kaçınabilirler.
Bir ajan, hücrelerde asyncio.run() hatalarıyla karşılaştığında veya IPython kernel'ları içinde gather veya TaskGroup kullanarak eşzamanlı görevleri yönetirken bu yeteneği yüklemelidir. Bu yetenek; top-level await uygulamanın, yeniden kullanılabilir mantığın .py modüllerinde yönetilmesinin ve bloklayıcı çağrılar yerine aiohttp veya httpx gibi kütüphanelerin seçilmesinin üzerine odaklanır. Kodun güvenilir kalmasını sağlamak ve temel tasarım sorunlarını maskelememek için nest_asyncio'yu birincil çözüm yerine bir yedek olarak değerlendirir.
Bir agent bununla neler yapabilir
- 1Event loop hatalarını düzeltmeBir notebook hücresi içinde asyncio.run() çağrılmasından kaynaklanan RuntimeError hatalarını giderin.
- 2Asenkron notebook kodunu refactor etmeDaha iyi test edilebilirlik için notebook hücrelerindeki satır içi (inline) asenkron yardımcı fonksiyonları harici Python modüllerine taşıyın.
- 3Bloklayıcı I/O sorunlarını önlemeEvent loop'u kilitleyen senkron çağrıları tespit edin ve bunları bloklamayan alternatiflerle değiştirin.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
python-notebooks-async skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.python-notebooks-async skill'ini Claude Code uygulamasına kur
~/.claude/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.claude/skills/python-notebooks-asyncpython-notebooks-async skill'ini Claude Code (project) uygulamasına kur
.claude/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async .claude/skills/python-notebooks-asyncpython-notebooks-async skill'ini Codex uygulamasına kur
~/.agents/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.agents/skills/python-notebooks-asyncpython-notebooks-async skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.gemini/skills/python-notebooks-asyncpython-notebooks-async skill'ini Claude.ai uygulamasına kur
npx degit ahgraber/skills/skills/python-notebooks-async python-notebooks-async && zip -r python-notebooks-async.zip python-notebooks-async # claude.ai → Customize → Skills → + → Create skill → Upload a skill → python-notebooks-async.zip
Otomatik kontroller
Çalıştırıldı 16 Kas 2026Tam rapor →Otomatik kontrollerimizi geçti. Bu bir güvenlik denetimi değil: bir ajanın çalıştırmasına izin vermeden önce betikleri okuyun. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirahgraber/skills/skills/python-notebooks-async is public and reachablegithub.com/ahgraber/skills/tree/HEAD/skills/python-notebooks ↗Geçti
- Açık kaynak lisansı (OSI)CC0-1.0spdx.org/licenses/CC0-1.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit 2026-10-29github.com/ahgraber/skills/commits ↗Geçti
- Betiklerde indir-çalıştır veya kimlik bilgisi hırsızlığı yokNo scripts in the skill folderGeçti
- SKILL.md içinde gizli talimat yokNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Geçti
- Önceden izin verilen araçlar sınırlıNo pre-approved tools; the agent asks before using onegithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Geçti
- SKILL.md, Agent Skills biçimine uyuyorValid name and description; says when to use it; 66 linesgithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Geçti
SKILL.md
GitHub'da görüntülePython Notebooks Async
Overview
Notebook kernels own the event loop; async code must cooperate with that ownership rather than fight it.
This skill covers orchestration patterns, top-level await, and compatibility constraints for .ipynb and #%% workflows.
Treat these recommendations as preferred defaults. When project constraints require deviation, call out tradeoffs and compensating controls.
When to Use
asyncio.run()raisesRuntimeErrorinside a notebook cell.- Event-loop conflicts when mixing async libraries in Jupyter.
- Porting async scripts into notebook workflows.
- Orchestrating concurrent tasks (
gather,TaskGroup) in IPython kernels. - Deciding where to place reusable async logic across notebook/module boundaries.
When NOT to Use
- Pure script or service code with no notebook involvement.
- Synchronous notebook workflows with no async needs.
- General asyncio API design outside notebook contexts — the
pythonskill covers concurrency audit defaults.
Invocation Notice
- Tell the user when this skill is running:
python-notebooks-async. Skip the notice when the user asked for the skill by name or slash command; spelling and spacing need not match. A phrase from this skill's own trigger list is not a name — naming the work is not naming the skill.
Quick Reference
- Treat notebook kernels as loop-owned environments; never create a competing loop.
- Use top-level
awaitinstead ofasyncio.run()in notebook cells. - Orchestrate concurrent work with
asyncio.gather()orasyncio.TaskGroup. - Keep reusable async logic in regular
.pymodules, imported into notebooks. - Use
nest_asyncioonly as a constrained compatibility fallback, not a default. - Avoid fire-and-forget tasks — always
awaitor collect results explicitly.
Common Mistakes
- Calling
asyncio.run()in a notebook cell. The kernel already runs a loop;asyncio.run()tries to start a second one and raisesRuntimeError. Useawaitdirectly instead. - Applying
nest_asyncioglobally by default. It patches the loop to allow reentrant calls but masks design problems and can hide subtle concurrency bugs. Reserve it for legacy compatibility. - Defining async helpers inline in cells instead of modules.
Inline definitions are lost on kernel restart and cannot be tested outside the notebook.
Extract to
.pyfiles. - Ignoring returned tasks or coroutines.
Calling an async function without
awaitsilently produces a never-executed coroutine object, with no error until results are missing downstream. - Mixing blocking I/O with async in the same cell.
Synchronous calls like
requests.get()block the event loop, starving concurrent tasks. Useaiohttp,httpx, orasyncio.to_thread().
References
references/notebooks-async.md— event-loop ownership, background-work and fire-and-forget patterns, script/notebook compatibility, blocking-library interop,nest_asynciopolicy
Bu becerideki dosyalar
2python-notebooks-async skill soruları
python-notebooks-async skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit ahgraber/skills/skills/python-notebooks-async ~/.claude/skills/python-notebooks-async komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
python-notebooks-async skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
Notebook içinde neden asyncio.run() RuntimeError hatası veriyor?
Notebook kernel'ı zaten bir event loop'a sahiptir ve onu çalıştırır; asyncio.run() çağırmak ikinci bir loop başlatmaya çalışır ve bu da çakışmaya neden olur. Bunun yerine top-level await kullanın.
Notebook iş akışlarımda nest_asyncio kullanmalı mıyım?
nest_asyncio'yu varsayılan bir çözüm olarak değil, yalnızca eski sistemlerden kaynaklanan kısıtlı bir uyumluluk yedeği olarak kullanmalısınız; çünkü bu yöntem tasarım hatalarını ve eşzamanlılık (concurrency) hatalarını gizleyebilir.
Bir notebook hücresinde event loop'un bloklanmasını nasıl önleyebilirim?
requests.get() gibi senkron ve bloklayıcı I/O işlemlerinden kaçının; bunun yerine aiohttp veya httpx gibi asenkron kütüphaneler kullanın ya da senkron çağrıları asyncio.to_thread() ile sarmalayın.