How does this skill help with MongoDB performance?

It enforces performance-critical rules like limiting embedded array sizes to 500 elements and targeting document sizes under 2MB to ensure optimal memory and network usage.

When does the skill suggest embedding versus referencing data?

It uses a specific decision tree: embed when data is small, bounded, and always accessed together; reference when data is shared, grows without bound, or is many-to-many.

Can I use this for existing MongoDB projects?

Absolutely. The skill includes compatibility checks to ensure new designs align with your existing repository's naming conventions and structural patterns.

Does it support financial data handling?

Yes, it strictly requires the use of Decimal128 for monetary and precision values to prevent the rounding errors common with standard floating-point numbers.

MongoDB Best Practices & Conventions

Name: MongoDB Best Practices & Conventions
Author: jsamuelsen11

byjsamuelsen11

0•

Database Management

Enforces professional MongoDB data modeling, BSON type selection, and schema design standards for high-performance database development.

This skill provides a comprehensive framework for MongoDB development, ensuring consistent document modeling and collection design. It guides Claude through critical architectural decisions, such as when to embed versus reference data, the application of design patterns like the Subset or Bucket patterns, and the correct usage of BSON types for precision and performance. By applying these conventions, developers can avoid common pitfalls like unbounded arrays or floating-point errors in financial data, resulting in more scalable, maintainable, and efficient MongoDB implementations.

Key Features

01Standardized collection naming and polymorphic design with discriminators

02Performance-focused constraints for array limits and document sizes

03Intelligent Embed vs. Reference decision logic based on data access patterns

04Advanced modeling patterns including Subset, Extended Reference, and Bucket patterns

050 GitHub stars

06Strict BSON type enforcement including Decimal128 for financial precision

Use Cases

01Conducting automated code reviews to ensure compliance with MongoDB best practices

02Designing a new MongoDB schema for a scalable web or mobile application

03Refactoring existing database code to improve query performance and data integrity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jsamuelsen11/claude-config mongodb-conventions

For use in Claude.ai and ChatGPT

Download Skill