claudekit/.claude/skills/databases/mongodb/SKILL.md

MongoDB

Description

MongoDB patterns including document design, queries, and aggregation.

When to Use

• MongoDB database operations
• Document-based data modeling
• Aggregation pipelines

---

Core Patterns

Document Operations

// Insert
db.users.insertOne({
  email: 'user@example.com',
  name: 'John',
  createdAt: new Date()
});

// Find
db.users.find({ active: true }).sort({ createdAt: -1 }).limit(20);

// Update
db.users.updateOne(
  { _id: ObjectId('...') },
  { $set: { name: 'Jane' } }
);

Aggregation

db.orders.aggregate([
  { $match: { status: 'completed' } },
  { $group: {
    _id: '$userId',
    totalSpent: { $sum: '$amount' },
    orderCount: { $count: {} }
  }},
  { $sort: { totalSpent: -1 } }
]);

Indexes

// Single field
db.users.createIndex({ email: 1 }, { unique: true });

// Compound
db.posts.createIndex({ userId: 1, createdAt: -1 });

Best Practices

1. Embed frequently accessed data
2. Use references for large/independent data
3. Create indexes for query patterns
4. Use aggregation for complex queries
5. Avoid unbounded arrays

Common Pitfalls

• Unbounded arrays: Limit array size
• Missing indexes: Analyze query patterns
• Over-embedding: Consider data access patterns