Skill python-notebooks-async
✓ VérifiéAide les agents à écrire et à réviser du code asyncio au sein de notebooks Jupyter ou de workflows par cellules afin d'éviter les conflits de boucle d'événements.
- Étoiles GitHub
- 6
- Fichiers
- 2
- Dernier commit
- 29 oct. 2026
- Licence
- CC0-1.0
- Outils autorisés
- —
Que fait la skill python-notebooks-async ?
Aide les agents à écrire et à réviser du code asyncio au sein de notebooks Jupyter ou de workflows par cellules afin d'éviter les conflits de boucle d'événements.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill python-notebooks-async
Les développeurs travaillant dans des notebooks Jupyter ou des workflows par cellules utilisent ce SKILL pour gérer le code Python asynchrone sans déclencher de conflits de boucle d'événements. Il fournit des directives pour les agents chargés d'écrire, de réviser ou de porter des scripts async vers des environnements où le noyau du notebook possède déjà la boucle d'événements. En suivant ces modèles, les agents peuvent éviter des erreurs courantes comme une RuntimeError lors de l'utilisation de asyncio.run() ou des tâches qui ne parviennent pas à se terminer silencieusement.
Un agent doit charger ce SKILL lorsqu'il rencontre des échecs liés à asyncio.run() dans des cellules ou lorsqu'il orchestre des tâches concurrentes à l'aide de gather ou TaskGroup au sein de noyaux IPython. Le SKILL se concentre sur l'implémentation du top-level await, la gestion de la logique réutilisable dans des modules .py, et le choix entre des bibliothèques comme aiohttp ou httpx au lieu d'appels bloquants. Il traite nest_asyncio comme une solution de secours plutôt que comme une solution primaire afin de garantir que le code reste fiable et évite de masquer des problèmes de conception sous-jacents.
Ce qu'un agent peut faire avec
- 1Correction d'erreurs de boucle d'événementsRésoudre les erreurs RuntimeError causées par l'appel de asyncio.run() à l'intérieur d'une cellule de notebook.
- 2Refactorisation de code async pour notebookDéplacer les fonctions utilitaires asynchrones en ligne des cellules de notebook vers des modules Python externes pour faciliter les tests.
- 3Prévention des problèmes d'I/O bloquantsIdentifier et remplacer les appels synchrones qui saturent la boucle d'événements par des alternatives non bloquantes.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill python-notebooks-async
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill python-notebooks-async dans Claude Code
~/.claude/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.claude/skills/python-notebooks-asyncInstaller la skill python-notebooks-async dans Claude Code (project)
.claude/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async .claude/skills/python-notebooks-asyncInstaller la skill python-notebooks-async dans Codex
~/.agents/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.agents/skills/python-notebooks-asyncInstaller la skill python-notebooks-async dans Gemini CLI
~/.gemini/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.gemini/skills/python-notebooks-asyncInstaller la skill python-notebooks-async dans Claude.ai
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
Vérifications automatisées
Exécuté le 16 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessibleahgraber/skills/skills/python-notebooks-async is public and reachablegithub.com/ahgraber/skills/tree/HEAD/skills/python-notebooks ↗Réussi
- Licence open source (OSI)CC0-1.0spdx.org/licenses/CC0-1.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-10-29github.com/ahgraber/skills/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 66 linesgithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Réussi
SKILL.md
Voir sur GitHubPython 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
Fichiers de cette skill
2Questions sur la skill python-notebooks-async
Comment installer la skill python-notebooks-async dans Claude Code ?
Exécutez npx degit ahgraber/skills/skills/python-notebooks-async ~/.claude/skills/python-notebooks-async. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill python-notebooks-async ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Pourquoi asyncio.run() lève-t-il une RuntimeError dans mon notebook ?
Le noyau du notebook possède et exécute déjà une boucle d'événements ; appeler asyncio.run() tente de démarrer une seconde boucle, ce qui provoque un conflit. Utilisez plutôt le top-level await.
Dois-je utiliser nest_asyncio dans mes workflows de notebooks ?
Vous ne devriez utiliser nest_asyncio que comme solution de repli pour des raisons de compatibilité avec des systèmes hérités, et non par défaut, car cela peut masquer des problèmes de conception et des bugs de concurrence.
Comment puis-je éviter de bloquer la boucle d'événements dans une cellule de notebook ?
Évitez d'utiliser des entrées/sorties (I/O) synchrones bloquantes comme requests.get() ; utilisez plutôt des bibliothèques asynchrones comme aiohttp, httpx, ou encapsulez les appels synchrones dans asyncio.to_thread().