Designing Python APIs
Python-Bibliotheks-API-Design: Benennung, Signaturen, Deprecation, Fail-Loud-Fehlerbehandlung.
Getestet · Funktioniert
Was es kann
Leitet das Design von Python-Bibliotheks-APIs — progressive Offenlegung, Keyword-only-Argumentmuster, benutzerdefinierte Ausnahmehierarchien und eine detaillierte 'fail loud, not silent'-Checkliste zur Vermeidung maskierter Fehler. Wird ausgelöst beim Entwerfen einer neuen Bibliotheks-API, Überprüfen einer bestehenden oder Planen einer Deprecation-/Versionsänderung; verweist auf einen begleitenden Release-Management-Skill für die Deprecation-Mechanismen.
Testbericht
Eine echte API-Designaufgabe wurde ausgeführt (add_task mit optionalen priority/due/recurring/notify): Die Version des Skills erzwang Keyword-only-Argumente, um einen Boolean-Trap-Bug zu eliminieren, den die Baseline unverändert lieferte, plus eine benutzerdefinierte Ausnahmehierarchie mit Hinweisen anstelle einer bloßen Exception.
Getestet am: 2026-07-14 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/wdm0006/python-skills cd python-skills mkdir -p ~/.claude/skills cp -r skills/python/api-design ~/.claude/skills/designing-python-apis
Befehle & Beispiel-Prompts
/designing-python-apisPython-Bibliotheks-API-Design: Benennung, Signaturen, Deprecation, Fail-Loud-Fehlerbehandlung.
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
Help me design the public API for a new Python caching library.Review this library's function signatures before we hit v1.0.How should I deprecate a parameter without breaking callers?