Recommend PyMongo AsyncMongoClient over deprecated Motor

[khelanmodi]

Summary

The connection skill (skills/connection/SKILL.md) lists Motor as the canonical Python async MongoDB driver. MongoDB announced Motor's deprecation in May 2024 in favor of PyMongo's built-in async API (AsyncMongoClient, GA in PyMongo 4.9, Sept 2024). Motor receives only critical fixes through May 2026 and is end-of-life after that.

This is the only place in the kit that mentions an async Python driver, so it acts as the default routing signal — agents triggered on ""DocumentDB + async Python"" tasks currently recommend Motor by default, steering users onto a deprecated driver.

Change

One-line wording fix plus a short deprecation callout so future contributors don't reintroduce Motor.

-- **Synchronous** (PyMongo, Java sync): Thread blocks; pool size often matches
-  thread pool size
-- **Asynchronous** (Node.js, Motor): Non-blocking I/O; smaller pools suffice
+- **Synchronous** (PyMongo `MongoClient`, Java sync): Thread blocks; pool size
+  often matches thread pool size
+- **Asynchronous** (Node.js, PyMongo `AsyncMongoClient`): Non-blocking I/O;
+  smaller pools suffice
+
+> **Python async note:** Use PyMongo's native `AsyncMongoClient` (PyMongo
+> 4.9+), **not** Motor. MongoDB announced Motor's deprecation in May 2024 in
+> favor of PyMongo's built-in async API; Motor receives only critical fixes
+> through May 2026 and is end-of-life after that.

References

• PyMongo 4.9 release notes — native async support
• MongoDB blog, May 2024: ""Motor is being deprecated in favor of PyMongo's native async API""

Validation

• pwsh scripts/validate-skills.ps1 still passes (17/17).
• No other Motor references exist in the repo (rg -i motor returns only this line).