mongo-conventions

Enforce MongoDB implementation patterns for async Python services.

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/eric-sabe/engsys --skill mongo-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mongo-conventions
Source: https://github.com/eric-sabe/engsys/tree/main/stacks/db/mongo/skills/mongo-conventions
Command: npx skills add https://github.com/eric-sabe/engsys --skill mongo-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent MongoDB implementation patterns lead to data loss, event loop blocking in async services, unrecoverable derived data, and untraceable data provenance in projects using MongoDB.

Core Features & Use Cases

  • Async Motor Access Patterns: Enforce non-blocking async driver usage for all request-path database operations, with centralized connection setup and idempotent index creation.
  • Append-Only Data Lake Discipline: Protect irreplaceable raw source data by treating downstream derived collections as replayable transforms, eliminating data loss from bulk reprocessing.
  • Mandatory Provenance Tracking: Ensure all stored data includes source and timestamp metadata, making aggregated results traceable to primary sources and avoiding incorrect default values.
  • Use Case: When building a content ingestion pipeline that stores crawled web data in MongoDB, this skill ensures raw payloads are never lost, derived embeddings can be rebuilt for free if deleted, and every content chunk is traceable to its original source URL and fetch timestamp.

Quick Start

Use the mongo-conventions skill to implement async Motor database access, set up an append-only raw data lake collection, and add provenance fields to all new MongoDB documents for your project's ingest pipeline.

Frequently Asked Questions about mongo-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent event loop blocking in async Python MongoDB services?

Prevent event loop blocking in async Python MongoDB services by enforcing non-blocking Motor async driver usage for all request-path database operations, centralized connection setup, and idempotent index creation to maintain async concurrency.

What is append-only data lake discipline in MongoDB ingest pipelines?

Append-only data lake discipline in MongoDB protects irreplaceable raw source data by treating downstream derived collections as replayable transforms, eliminating data loss risks during bulk reprocessing of ingest pipelines.

How to add provenance metadata to MongoDB documents for traceable data?

Add provenance metadata to MongoDB documents by ensuring all stored data includes mandatory source and timestamp metadata, making aggregated results traceable to primary sources and avoiding incorrect default values.

Does the Motor async driver support idempotent index creation for MongoDB?

Yes, the Motor async driver supports idempotent index creation for MongoDB by enforcing centralized connection setup and non-blocking async access patterns, ensuring indexes are created safely without blocking the event loop.

What's the best way to structure a MongoDB data lake for crawled web data?

The best way to structure a MongoDB data lake for crawled web data is to enforce append-only raw payload collections, ensuring derived embeddings can be rebuilt for free and every content chunk remains traceable to its original source URL and fetch timestamp.

Why does inconsistent MongoDB indexing cause unrecoverable derived data?

Inconsistent MongoDB indexing and implementation patterns cause unrecoverable derived data because without append-only raw lake discipline and provenance tracking, bulk reprocessing can overwrite or lose the original source payloads needed to replay transforms.