amazon-documentdb

Manages Amazon DocumentDB clusters, migrations, upgrades, and performance reviews via AWS CLI workflows.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill amazon-documentdb-sakicodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: amazon-documentdb
Source: https://github.com/sakicodes/BuildFestHackathon26/tree/main/.agents/skills/amazon-documentdb
Command: npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill amazon-documentdb-sakicodes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires boto3, and includes scripts (resource) and references (resource) components.

What problem does it solve? Setting up, migrating to, and operating Amazon DocumentDB involves many AWS-specific pitfalls — TLS configuration, VPC-only networking, MongoDB compatibility gaps, DMS cutover orchestration, and major version upgrades — that cause production incidents when handled from generic MongoDB knowledge alone. ## Core Features & Use Cases - Cluster Setup & Connection: Creates serverless DocumentDB 8.0 clusters with correct TLS, VPC, security group, and driver configuration for Python, Node.js, Java, Go, C#, and Ruby. - MongoDB Migration: Runs compatibility assessments with the amazon-documentdb-tools compat tool, migrates indexes, and orchestrates DMS full-load-plus-CDC migrations with a structured cutover checklist. - Operations & Reviews: Diagnoses slow queries via explain() and COLLSCAN analysis, executes 41-check Well-Architected reviews with wa_review.py, and manages major version upgrades (4.0→5.0→8.0) in-place or near-zero-downtime. - Use Case: A team moving a MongoDB product catalog to AWS asks for help — the skill assesses operator compatibility, pre-creates indexes, runs the DMS migration with CDC, validates data, and produces a cutover plan. ## Quick Start Ask the assistant to create a new Amazon DocumentDB serverless cluster in your preferred region and generate a working connection string for your application.

Frequently Asked Questions about amazon-documentdb

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

FAQPage Schema
How do I migrate MongoDB to Amazon DocumentDB?

Run the amazon-documentdb-tools compat tool against your MongoDB source first to find unsupported operators, then pre-create indexes with the index tool. Set up a DMS full-load-and-cdc task with TLS verify-full on the target endpoint, monitor CDC latency, and cut over when lag reaches zero.

How do I fix a Lambda function that cannot connect to DocumentDB?

Lambda must run in the same VPC as the DocumentDB cluster, which has no public endpoint. Add an inbound TCP 27017 rule on the DocumentDB security group sourced from Lambda's security group ID, and include tls=true, the RDS global CA bundle, replicaSet=rs0, and retryWrites=false in the connection string.

Does DocumentDB support $graphLookup and wildcard indexes?

Support varies by engine version, so check the MongoDB API compatibility page before relying on them. If unsupported, use the materialized ancestor path pattern for hierarchy queries and targeted compound indexes on known attribute paths instead of wildcard indexes.

Why does my DocumentDB query show COLLSCAN and run slowly?

COLLSCAN in explain() output means no index serves the query. Create a compound index following the ESR rule (equality, sort, range fields in order), then re-run explain() to confirm IXSCAN and check BufferCacheHitRatio in CloudWatch to verify the index stays in memory.

How do I upgrade DocumentDB from 4.0 or 5.0 to 8.0?

Use in-place modify-db-cluster with --allow-major-version-upgrade and a target-family parameter group, or the near-zero-downtime path: clone the cluster, upgrade the clone, replicate changes via DMS CDC, then cut over. Versions cannot be skipped, so 3.6 requires stepping through 5.0 first.

What are the limitations of DocumentDB Elastic Clusters?

Elastic Clusters lack transactions, change streams, and many aggregation operators compared to instance-based clusters. The skill steers workloads to serverless or provisioned instance-based clusters instead, reserving Elastic Clusters only for sharding needs that exceed the largest instance classes.