Amazon Elasticache
AWSOfficialPublished by AWS
- Skill
- Tool integration
- Cloud and DevOps
- Apache-2.0
- Medium risk
- Has scripts
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
The Amazon ElastiCache skill provides a structured, modular approach to managing in-memory data stores on AWS. It guides developers through the entire lifecycle of ElastiCache and Valkey, from initial requirements gathering and provisioning to complex data modeling, AI-driven vector search, and operational monitoring. The skill enforces best practices for connection safety, security, and infrastructure-as-code, ensuring reliable performance for caching, session management, and GenAI workloads.
What it does
- Assesses workload requirements to recommend optimal ElastiCache configurations.
- Automates provisioning and connectivity setup for serverless and node-based clusters.
- Provides implementation patterns for common use cases like cache-aside, session stores, and rate limiting.
- Supports advanced AI workloads including semantic caching, RAG, and vector similarity search.
- Delivers operational diagnostics for performance tuning, cost optimization, and troubleshooting.
- Manages migration paths from self-managed Redis or between different deployment models.
When to use it
- When you need to reduce database load or improve API response times with an in-memory cache.
- When implementing AI agent memory, RAG retrieval, or semantic caching for LLM applications.
- When migrating existing Redis workloads to a managed AWS environment.
- When troubleshooting performance issues like high latency, replication lag, or memory pressure.
- When setting up secure, production-ready caching infrastructure using IaC.
Advantages
- Standardizes deployment and operational patterns across development teams.
- Ensures compliance with security best practices like TLS and IAM authentication.
- Reduces configuration errors through automated input validation and tagging.
- Provides clear guidance on engine selection and version-specific feature availability.
- Simplifies complex tasks like cross-region migration and vector search setup.
Usage examples
- “I need to speed up my RDS database. Should I use ElastiCache?”
- The agent will initiate the requirements sub-skill to analyze your workload, stack, and latency needs, then provide a recommendation on whether ElastiCache is the right fit.
- “How do I set up a Valkey cluster for vector search?”
- The agent will route to the genai sub-skill, verify you are using a node-based Valkey 8.2+ cluster, and provide the necessary configuration and code to enable vector similarity search.
- “My cache hit rate is low and latency is spiking. Can you help me troubleshoot?”
- The agent will activate the monitoring sub-skill to analyze your metrics, identify potential hot keys or memory imbalance, and suggest specific remediation steps.
- “Help me migrate my self-managed Redis to ElastiCache.”
- The agent will guide you through the migration sub-skill, performing preflight checks and validating your source configuration for a zero-downtime cutover.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/aws/amazon-elasticache/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip amazon-elasticache.zip -d .agents/skills
Documentation by AWS
ElastiCache
A modular ElastiCache toolkit organized as a registry of sub-skills. Each sub-skill handles one domain of ElastiCache work. The router below matches user intent to the right sub-skill, then loads only the references needed for that sub-skill.
How this skill works
Match the user's request against the semantic categories in the registry below. Match on meaning, not exact wording ("help me figure out which data structures to use" matches
data-modelingeven without the word "pattern").Disambiguation: If the user's intent matches multiple sub-skills, apply these rules in order:
If
.elasticache/requirements.jsonexists withinfrastructure.endpointset, prefermonitoringordata-modeling(the user has an existing cache).If no cache exists (no requirements.json or no endpoint), prefer
requirements.If still ambiguous, ask one clarifying question: "Are you looking to set up something new, or troubleshoot something existing?"
Check the Guardrails section before recommending an engine or deployment model.
Read
references/{sub-skill-id}/instructions.mdfor the matched sub-skill. If the file is not found at a relative path, check your prompt or environment for the skill directory absolute path and retry with{skill-directory}/references/{sub-skill-id}/instructions.md.If the request spans multiple sub-skills, execute them in pipeline order.
If a sub-skill requires upstream context (engine, deployment model, endpoint) not yet in session memory, route to the upstream sub-skill first.
If no sub-skill matches, activate
requirementsfirst.If a script or CLI call fails, show the error to the user and suggest a specific fix before retrying.
Sub-skill registry
Each entry has: an ID (directory name under references/), a domain description, semantic categories for matching, and upstream/downstream dependencies.
| ID | Name | Domain | Semantic Categories | Upstream | Downstream |
|---|---|---|---|---|---|
requirements | Solution Fit | Gathers workload, stack, scale, latency, persistence, and budget through workspace scan + structured interview. Decides whether ElastiCache is the right service and hands off with a routing recommendation. | I need a cache, speed up my app, reduce database load, lower Bedrock cost, should I use ElastiCache, what's best for my workload, evaluating cache options, ElastiCache vs X, Valkey vs X, vague new workload | — | setup, data-modeling, genai, monitoring, migration |
setup | Create and Connect | Provisioning, connectivity, security, authentication, IaC, deployment choice. Gets the user to a working cache with least friction. Covers engine selection, serverless vs node-based, VPC, TLS, RBAC/IAM, jump-host/SSM tunnels, CLI/SDK/CFN/CDK/Terraform starters. | create a cache, set up ElastiCache, provision, Valkey cluster, connect Lambda/ECS/EKS/EC2, VPC, security groups, TLS, RBAC, IAM auth, jump host, SSM tunnel, CloudFormation, CDK, Terraform, engine selection, serverless vs node-based, backup, snapshot, restore, export | requirements (optional) | data-modeling, genai, monitoring |
data-modeling | Application Patterns | Picks data structures, key schema, TTL strategy, invalidation approach, and client code for non-AI patterns: cache-aside, session store, rate limiting, leaderboards, counters, pub/sub, streams, shopping carts, job queues, activity feeds. | session store, rate limiting, leaderboard, cache-aside, query caching, counters, streams, pub/sub, shopping cart, job queue, activity feed, key schema, TTL, invalidation, data structures | setup (cache must exist) | monitoring |
genai | AI and Vector Workloads | Classifies request into Mode 1 (plain cache), Mode 2 (semantic response cache), or Mode 3 (full vector search). Selects Valkey and forces node-based Valkey 8.2 or above (recommend 9.0) when server-side vector similarity is needed. Covers semantic caching, agent memory, RAG retrieval, recommendation, personalization, conversation/session persistence for AI agents, and framework wiring (Strands, mem0, LangChain). | semantic cache, RAG, agent memory, conversational memory, vector search, embeddings, recommendation, personalization, Bedrock latency, Bedrock cost, LLM caching, Strands, mem0, LangChain, conversation history, AI session store, embedding provider, framework integration | setup (cache must exist) | monitoring |
monitoring | Operate and Observe | Diagnoses performance, cost, and reliability using metrics first, then recommends the smallest change. Covers dashboards, alarms, log delivery, cost reporting, event routing, troubleshooting high CPU / memory / replication lag / connection spikes / low hit rate / hot keys / big keys / slot imbalance / latency spike root cause. | cache is slow, cost too high, hit rate low, high CPU, memory pressure, replication lag, connection spikes, dashboards, alarms, CloudWatch, cost comparison, troubleshoot, hot key, uneven shard load, one node pinned, big key, memory bloat, which key is biggest, keyspace distribution, prefix analysis, cost attribution by tenant, memory imbalance, one shard full, slot memory skew, latency spike, slow command incident, root cause for latency bump | — | setup, migration |
migration | Engine and Platform Migration | Selects the migration path and sequences preflight, validation, cutover, and rollback. Covers self-managed Redis → ElastiCache, Redis OSS → Valkey, node-based ↔ serverless, version upgrades. Hard validate-before-migrate gate. | migrate, Redis OSS to Valkey, self-managed to ElastiCache, node-based to serverless, serverless to node-based, engine upgrade, version upgrade, zero-downtime cutover, rollback | — | setup, monitoring |
Pipeline order
Sub-skills run independently, but common multi-step journeys follow these pipelines:
requirements→setup→ (data-modeling|genai) →monitoringmigration→setup→monitoringmonitoring→setup|migration(if metrics indicate)
State handoff: requirements.json
.elasticache/requirements.json is the single source of truth for cross-sub-skill state. Each sub-skill reads it at start and writes its section after completing work. Read before writing; merge, do not overwrite.
| Section | Owner | Key fields |
|---|---|---|
| top-level | requirements | engine, deployment_model, region, runtime, patterns, use_case, vpc_id, subnet_ids, security_group_ids |
infrastructure | setup | cache_name, resource_id, engine_version, topology, endpoint, port, auth_model, tls, client_library, execution_path, access_mode, tunnel_instance_id, embedding_provider, embedding_model, embedding_dim, embedding_module |
genai | genai | mode, mode_2_path, framework |
migration | migration | source_type, source_host, migration_path, cutover_status |
Ownership note:
deployment_modelis set byrequirementsduring initial interview.migrationmay update it after an engine or deployment model switch (e.g., node-based to serverless).
requirements.json should include "schema_version": 1 and "last_updated": "<ISO timestamp>" at the top level. Every sub-skill that writes to requirements.json must update last_updated. If last_updated is older than 7 days, warn the user that cached state may be stale.
requirements.json tracks one active cache. If the user works with multiple caches in the same project, confirm which cache is active before reading or writing state.
When a sub-skill needs upstream context (engine, endpoint, auth model), check requirements.json first. If the field is null or the file does not exist, route to the upstream sub-skill.
Global rules (apply to every sub-skill)
Execution path. Use AWS CLI, SDK (boto3), CloudFormation, or CDK as the primary path for control-plane work. Use valkey-py as the primary path for data-plane work.
Response depth. Summary (2-3 sentences) for "should I" or "which" questions. Standard (recommendation + config + code + next steps) by default. Expert (full decision matrix with alternatives, cost, security caveats) for "why" or "compare all" questions. Escalate on user request; never downgrade unprompted.
Session memory. Track region, VPC, engine, deployment model, auth model, compute runtime, and language. Carry forward across sub-skills. Do not re-ask. If the user overrides a value, update it everywhere. Inferred values (from workspace scan or IaC) must be re-confirmed before high-risk decisions (engine, deployment model, security posture); low-risk inferences (language, framework, region) can be used as defaults silently.
Source priority. Always answer from skill-local files first (sub-skill references, then
scripts/). Do not fetch external documentation or web search unless the local files cannot answer the query. When local files are insufficient, fall back to official AWS docs: https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/ for features and https://aws.amazon.com/elasticache/pricing/ for pricing. Never invent price points or version constraints. If the user references a Valkey or Redis version, feature, or pricing tier not covered in local files, fall back to https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/ before answering. Do not extrapolate from local content that may be outdated.Freshness disclaimer. When outputting pricing, version constraints, or feature availability, include a one-line disclaimer: "For current pricing see https://aws.amazon.com/elasticache/pricing/. For current feature availability see https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/."
Connection safety. Never create a Valkey/Redis client at module level (top of file, import time). Initialize connections inside a function or on first use. Module-level connections crash applications that import the module before the cache is reachable.
Code environment. Use
python3(notpython) in all commands and shebangs. Do not generatepip installorpytestcommands in application code. Prefer the agent's file-writing tool over shell redirection for writing files.Input validation (write operations only). Before running any create, modify, or delete CLI command or SDK call that uses user-provided values (cache name, region, subnet IDs, security group IDs, VPC ID, KMS key, snapshot name), validate them with
scripts/input_validator.py. Runpython3 scripts/input_validator.py cache_name=<val> region=<val> ...or importvalidate_allas a library. Skip validation for read-only operations (describe, list) where bad input is harmless.Resource tagging (always apply on resource creation). When creating any cache (
create-serverless-cache,create-replication-group,create-cache-cluster), ALWAYS include these tags:--tags Key=managed_by,Value=aws-skills Key=skill,Value=elasticache Key=skill_version,Value=1.0.0 Key=created_by,Value=elasticache-skill Key=generation_model,Value={your-model-id}Example:
--tags Key=managed_by,Value=aws-skills Key=skill,Value=elasticache Key=skill_version,Value=1.0.0 Key=created_by,Value=elasticache-skill Key=generation_model,Value=claude-sonnet-4-20250514Set
generation_modelto your own model identifier. Include these tags even if the user does not mention tagging. If the user provides additional tags, append these to their tags rather than replacing them.
Reference loading
Load additional references only when the current turn's answer requires them.
On-demand pointers (not preloaded; fetch when the trigger applies):
references/shared-ux/production-readiness.md— when the user asks if their cache is ready for production, or after setup completes and the user wants to go to productionreferences/shared-ux/action-safety.md— before any destructive action (risk levels, never-auto-execute list)references/shared-ux/error-remediation.md— when the user hits a specific ElastiCache error code (MOVED, CROSSSLOT, CLUSTERDOWN, MULTI/EXEC+IAM, etc.)references/shared-foundation/boundary-doc.md— when the user asks what this skill coversreferences/shared-foundation/attribution.md— when generating CLI commands, SDK code, or IaC templatesreferences/shared-foundation/architecture-diagrams.md— when the user asks for architecture diagrams or visual referencereferences/shared-runtime/lambda.md— when connecting from Lambda (cold start gotchas, IAM auth code, lazy init)references/shared-runtime/ecs.md— when connecting from ECS (SIGTERM shutdown, connection pool drain, task definition)references/shared-runtime/eks.md— when connecting from EKS (IRSA, service mesh bypass, SecurityGroupPolicy CRD)references/shared-runtime/api-gateway.md— when integrating with API Gateway (no direct path, caching layers comparison)references/shared-runtime/rds-acceleration.md— when caching RDS/Aurora queries (thundering herd, stampede protection, invalidation)references/shared-runtime/secret-injection.md— when the user asks about credential management per compute platformreferences/shared-security/encryption-defaults.md— when adding encryption to an existing unencrypted cluster (TLS two-step migration, at-rest immutability)references/shared-security/config-guardrails.md— when the user wants continuous compliance monitoring (AWS Config rules, custom Lambda rules)references/shared-security/vpc-patterns.md— when debugging port/security-group issues (port 6380 serverless reader, anti-patterns)
Folder convention:
references/contains 10 folders. 6 match the sub-skills (requirements,setup,data-modeling,genai,monitoring,migration) and are routing destinations. The 4shared-*folders (shared-foundation,shared-ux,shared-security,shared-runtime) are cross-cutting material loaded on demand, not routing destinations.
Guardrails
| Priority | Rule |
|---|---|
| CRITICAL | Vector search MUST use node-based Valkey 8.2 or above. Serverless does NOT support vector search. Never suggest serverless for vector search. Apply this regardless of which sub-skill activates. |
| CRITICAL | Do not invent price points or version constraints. Use scripts/price_calculator.py and current AWS docs when precision matters. |
| HIGH | Do not recommend Memcached when the user needs persistence, replication, RBAC or IAM auth, sorted sets, streams, pub/sub, or vector search. |
| HIGH | Do not assume local laptop access works directly. ElastiCache is VPC-centric; explain VPC, tunnel, or jump-host access when needed. |
| STANDARD | Do not trigger on every generic Redis mention. Trigger when the user is clearly asking about AWS, managed caching, migration, connectivity, pricing, operations, or AWS service integration. |
| STANDARD | For ambiguous "cache" requests inside AWS contexts, activate this skill and start with requirements. |
Product truths
ElastiCache Serverless deploys in under a minute and removes infrastructure management.
Valkey serverless pricing is 33% lower than other supported engines; node-based Valkey pricing is 20% lower.
Serverless caches have in-transit encryption always enabled (cannot be disabled).
IAM auth is available for all ElastiCache Valkey versions (7.2 is the baseline Valkey version on ElastiCache) and Redis OSS 7.0+.
Valkey version ladder: 7.2 (baseline), 8.0 (20% more data per node (capacity improvement), per-slot metrics), 8.1 (Bloom filters, COMMANDLOG, SET IFEQ, 20% less memory via new hash table (efficiency improvement)), 8.2 (vector search), 9.0 (recommended default for new clusters). Recommend Valkey 9.0 for new clusters unless a specific feature dictates otherwise.
Vector search is available for Valkey 8.2 or above on node-based clusters (recommend 9.0).
Global Datastore is available for node-based clusters only. It does not support IPv6 or Local Zones. Global Datastore supports AUTH and RBAC. Cross-region failover must be promoted manually (no autofailover across regions). At-rest encryption must be enabled on all clusters in the Global Datastore, but each cluster can use a separate KMS key per region.
Online migration from self-managed Redis to ElastiCache requires: (source) AUTH must not be enabled,
protected-modeset tono, replication and administrative commands must not be renamed (e.g.,sync,psync,info,config,command,cluster); (target) encryption in-transit disabled, Multi-AZ enabled, engine version Redis OSS 5.0.6+ or Valkey 7.2+, not part of a Global Datastore, data tiering disabled. Shard counts must match between source and target. All source Redis instances must use the same port. Online migration is not supported for serverless caches (node-based targets only). Seereferences/migration/topology-validation.mdfor the full checklist.
Files
- ATTRIBUTION.mdAdded by AutoGineer924 B
- LICENSELicence file added by AutoGineer9.9 KiB
- NOTICELicence file added by AutoGineer67 B
- SKILL.md17.8 KiB
- assets/examples/sample_commandstats.csv882 B
- assets/examples/sample_input_simple.csv449 B
- references/data-modeling/command-availability.md6.1 KiB
- references/data-modeling/common-patterns.md8.6 KiB
- references/data-modeling/instructions.md9.9 KiB
- references/data-modeling/memcached-recipe.md5.2 KiB
- references/data-modeling/recipe-gallery.md8.2 KiB
- references/genai/agent-memory.md5.9 KiB
- references/genai/elasticache-search.md16.9 KiB
- references/genai/embedding-providers.md8.6 KiB
- references/genai/framework-guide.md4.9 KiB
- references/genai/instructions.md9.7 KiB
- references/genai/rag-retrieval.md9.3 KiB
- references/genai/semantic-cache.md8.9 KiB
- references/genai/session-store.md6.4 KiB
- references/migration/auth-migration.md14.4 KiB
- references/migration/feature-comparison.md10.9 KiB
- references/migration/global-datastore-operations.md8.0 KiB
- references/migration/instructions.md14.8 KiB
- references/migration/rollback-procedures.md16.9 KiB
- references/migration/self-managed-migration.md14.6 KiB
- references/migration/sizing-assessment.md6.8 KiB
- references/migration/topology-validation.md8.1 KiB
- references/migration/upgrade-patching.md13.2 KiB
- references/migration/valkey-migration-guide.md13.5 KiB
- references/monitoring/alarm-packs.md8.4 KiB
- references/monitoring/big-key-hunter.md6.8 KiB
- references/monitoring/client-tuning-and-diagnostics.md11.8 KiB
- references/monitoring/cloudwatch-dashboards.md7.7 KiB
- references/monitoring/cost-reporting.md11.9 KiB
- references/monitoring/event-routing.md9.5 KiB
- references/monitoring/hot-key-detection.md10.8 KiB
- references/monitoring/instructions.md8.8 KiB
- references/monitoring/key-space-distribution-by-prefix.md6.8 KiB
- references/monitoring/log-delivery.md7.9 KiB
- references/monitoring/slot-memory-imbalance-detection.md6.7 KiB
- references/monitoring/slow-log-cross-signal-diagnosis.md8.5 KiB
- references/monitoring/troubleshooting.md17.9 KiB
- references/requirements/instructions.md9.9 KiB
- references/setup/auth-model-selector.md3.3 KiB
- references/setup/cluster-topology.md3.6 KiB
- references/setup/connection-guide.md6.4 KiB
- references/setup/connectivity-diagnostics.md6.9 KiB
- references/setup/create-secure-cache.md8.4 KiB
- references/setup/engine-selection.md2.1 KiB
- references/setup/iac-best-practices.md7.3 KiB
- references/setup/iac-reference.md6.2 KiB
- references/setup/iam-policies.md2.7 KiB
- references/setup/instructions.md8.6 KiB
- references/setup/serverless-vs-node.md12.7 KiB
- references/setup/service-quotas.md2.9 KiB
- references/shared-foundation/architecture-diagrams.md8.0 KiB
- references/shared-foundation/attribution.md3.7 KiB
- references/shared-foundation/boundary-doc.md4.9 KiB
- references/shared-runtime/api-gateway.md5.4 KiB
- references/shared-runtime/ecs.md7.5 KiB
- references/shared-runtime/eks.md10.5 KiB
- references/shared-runtime/lambda.md10.1 KiB
- references/shared-runtime/rds-acceleration.md12.6 KiB
- references/shared-runtime/secret-injection.md14.1 KiB
- references/shared-security/config-guardrails.md8.0 KiB
- references/shared-security/encryption-defaults.md4.2 KiB
- references/shared-security/vpc-patterns.md2.8 KiB
- references/shared-ux/action-safety.md9.8 KiB
- references/shared-ux/error-remediation.md12.1 KiB
- references/shared-ux/production-readiness.md5.5 KiB
- scripts/collect_metrics.shScript5.2 KiB
- scripts/command_classifier.pyScript6.2 KiB
- scripts/find_tunnel_host.pyScript7.2 KiB
- scripts/generate_dashboards.pyScript27.1 KiB
- scripts/input_validator.pyScript10.6 KiB
- scripts/migration_preflight.pyScript19.5 KiB
- scripts/price_calculator.pyScript14.4 KiB
- scripts/pricing.pyScript20.2 KiB
- scripts/security_audit.pyScript19.5 KiB
- scripts/serverless_estimator.pyScript28.4 KiB
- scripts/start_tunnel.pyScript11.7 KiB
- scripts/test_connection.pyScript13.3 KiB
- scripts/validate_references.pyScript10.6 KiB
references/shared-ux/action-safety.md
Action Safety Guide
Safety semantics for destructive and high-impact ElastiCache operations. Every action that can cause data loss, downtime, or irreversible changes must follow the safeguards defined here.
Safety Levels
| Risk Level | Definition | Required Safeguards |
|---|---|---|
| High | Data loss or significant downtime likely. Irreversible. | Explicit user confirmation. Final snapshot. Impact explanation. |
| Medium | Possible disruption or partial data impact. May be reversible with effort. | User confirmation. Recommend snapshot. Explain impact. |
| Low | Minimal risk. Fully reversible or non-destructive. | Inform the user. Proceed with standard confirmation. |
Action Safety Matrix
High Risk Actions
DELETE Cache (Serverless or Node-Based)
Risk level: High Reversibility: Irreversible. All data is permanently deleted unless a final snapshot is taken.
Required safeguards:
Always suggest a final snapshot before deletion. Ensure the caller has
elasticache:CreateSnapshotpermission (orelasticache:CreateServerlessCacheSnapshotfor serverless); without it, the API call will fail with anAccess Deniedexception.Require explicit user confirmation with the cache name.
Warn that all data, connections, and endpoints will be destroyed.
Note that manual snapshots are retained after deletion, but automatic cache snapshots are NOT retained. A final snapshot or existing manual snapshot is the only recovery path.
Confirm the cache is not referenced by active applications.
Implementation:
Option A (recommended): Use
--final-snapshot-identifieron the delete call. This atomically creates a snapshot during deletion in a single step. Option B below creates a separate snapshot first, which is useful if you want to verify the snapshot before proceeding with deletion.
# Option A: Delete with atomic final snapshot (single step)
aws elasticache delete-replication-group \
--replication-group-id my-cluster \
--final-snapshot-identifier my-cluster-final-$(date +%Y%m%d-%H%M%S) \
--region us-east-1# Option B: Create snapshot first, verify, then delete (two steps)
# Step 1: Create and verify snapshot
aws elasticache create-snapshot \
--replication-group-id my-cluster \
--snapshot-name my-cluster-final-$(date +%Y%m%d-%H%M%S) \
--region us-east-1
aws elasticache describe-snapshots \
--snapshot-name my-cluster-final-<timestamp> \
--region us-east-1
# Step 2: Delete without final snapshot (already taken above)
aws elasticache delete-replication-group \
--replication-group-id my-cluster \
--region us-east-1For serverless:
aws elasticache delete-serverless-cache \
--serverless-cache-name my-cache \
--final-snapshot-name my-cache-final-$(date +%Y%m%d-%H%M%S) \
--region us-east-1FLUSHALL / FLUSHDB
Risk level: High Reversibility: Irreversible. All keys in the database (FLUSHDB) or all databases (FLUSHALL) are permanently deleted.
Required safeguards:
Warn about complete data loss.
Suggest taking a snapshot before flushing.
Require explicit user confirmation.
Confirm this is intentional and not a cache invalidation scenario (where targeted
DELor TTL-based expiry is more appropriate).
Guidance to present to the user:
FLUSHALL removes ALL data from ALL databases on the cache.
FLUSHDB removes ALL data from the currently selected database.
There is no undo. A snapshot taken before the operation is the only recovery path.
For cache invalidation, consider using
DELfor specific keys,UNLINKfor async deletion, or TTL-based expiry instead.
Engine Upgrade (Major Version)
Risk level: High Reversibility: Difficult. Downgrade is not supported in-place for major version changes, with one exception: Valkey 7.2 can be rolled back in-place to Redis OSS 7.1 (this is the documented cross-engine rollback path).
Required safeguards:
Flag compatibility concerns before proceeding.
Recommend testing the new engine version in a staging environment first.
Create a snapshot before the upgrade.
Check for deprecated commands or behavior changes in the target version.
Verify client library compatibility with the new engine version.
For Redis OSS to Valkey migration, versions 5.0.6+ support zero-downtime migration with Multi-AZ enabled; earlier versions are supported but may experience 30–60 seconds of failover during DNS propagation. Still recommend a snapshot.
Implementation:
# Step 1: Snapshot
aws elasticache create-snapshot \
--replication-group-id my-cluster \
--snapshot-name pre-upgrade-$(date +%Y%m%d) \
--region us-east-1
# Step 2: Modify engine version (cross-engine upgrade to Valkey example)
aws elasticache modify-replication-group \
--replication-group-id my-cluster \
--engine valkey \
--engine-version 8.0 \
--cache-parameter-group-name my-valkey8-param-group \
--apply-immediately \
--region us-east-1Medium Risk Actions
Failover (Manual or Test)
Risk level: Medium Reversibility: Reversible (fail back). Brief connectivity disruption during promotion.
Required safeguards:
Explain the impact: the primary will be demoted, a replica will be promoted, and clients will experience a brief disconnection (typically seconds).
Suggest performing during a maintenance window or low-traffic period.
Verify automatic failover is enabled and replicas are healthy before testing.
Confirm the application handles reconnection gracefully (cluster-aware clients, retry logic).
Implementation:
aws elasticache test-failover \
--replication-group-id my-cluster \
--node-group-id 0001 \
--region us-east-1Modify That Causes Downtime
Risk level: Medium Reversibility: Varies by modification type.
Operations that may cause downtime or brief disruption:
Changing node type (vertical scaling).
Changing number of shards (horizontal scaling).
Enabling cluster mode (migration from disabled to enabled via compatible mode; can be reverted from "compatible" back to "disabled", but cannot be reverted once set to fully "enabled").
Changing engine version (minor or major).
Changing at-rest encryption (requires creating a new cluster).
Enabling in-transit encryption (can be done in-place via a two-step process: set transit encryption mode to
preferred, then torequired; no new cluster needed).
Required safeguards:
Flag that the modification may cause brief downtime or failover.
Explain the specific impact (e.g., "node type change triggers a rolling replacement with brief failover per shard").
Recommend applying during a maintenance window:
--no-apply-immediatelyfor non-urgent changes.For production caches, suggest testing the modification in staging first.
Scale-Down (Node Type or Shard Count)
Risk level: Medium Reversibility: Reversible (scale back up), but data loss is possible with Memcached.
Required safeguards:
For Memcached: Warn about data loss. Memcached has no persistence or replication. Scaling down removes nodes and their data permanently.
For Valkey/Redis OSS node-based: Data is redistributed during shard removal. Brief disruption during rebalancing. Verify sufficient memory on remaining shards.
For serverless: Scaling is automatic; manual scale-down is not applicable.
Verify the remaining capacity can handle the current data size and throughput.
Modify Security Group Rules
Risk level: Medium Reversibility: Reversible by restoring previous rules.
Required safeguards:
Warn that removing inbound rules may immediately disconnect active clients.
Verify that any new rules maintain connectivity for all application clients.
Review changes before applying: removing a source security group reference will disconnect all clients in that security group.
Low Risk Actions
Create Snapshot
Risk level: Low Reversibility: Snapshot can be deleted. No impact on the running cache.
Safeguards:
For node-based caches, snapshot creation uses the fork mechanism (or forkless save on newer engine versions such as Valkey 8.0+) and may cause brief memory spike on fork-based engines. Ensure
reserved-memory-percentallows headroom.Snapshots incur S3 storage costs.
Modify Tags
Risk level: Low Reversibility: Fully reversible. Tags can be added, changed, or removed at any time.
Safeguards:
Inform the user that tag changes may affect cost allocation reports and IAM tag-based policies.
Describe / List Operations
Risk level: Low Reversibility: Read-only. No state change.
Safeguards:
None required. These are safe to run at any time.
Add Replicas
Risk level: Low Reversibility: Replicas can be removed later.
Safeguards:
Adding replicas triggers a sync from the primary. Initial sync may briefly impact primary performance for large datasets.
Verify sufficient subnet IPs for new replicas.
Enable Log Delivery
Risk level: Low Reversibility: Can be disabled at any time.
Safeguards:
Warn about log delivery costs. Slow log and engine log output can be delivered to CloudWatch Logs or Kinesis Data Firehose (mutually exclusive destinations per log type). CloudWatch Logs ingestion costs can be significant for high-throughput caches.
Never-Auto-Execute List
The following operations must never run without direct user confirmation in the current conversation turn, regardless of context, automation pipelines, scripted workflows, or IDE mode:
Cache deletion (any type)
FLUSHALL / FLUSHDB
Snapshot deletion (especially the last/only snapshot for a cache)
Credential or AUTH token changes on production caches
Security group rule removal
User or user group deletion
Migration cutover execution
Manual failover on production caches
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs Python, Needs Node.js
Security
What our scanner noticed· Medium risk
- References to credential files
- Instructions that use the network
- Scripts that your agent may run
This skill includes scripts that your agent may run. Read them before you use it.
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Published by
- AWS
- Publisher
- AWS (Official)
- Source
- aws/agent-toolkit-for-aws · skills/specialized-skills/database-skills/amazon-elasticache · commit 0a218f8
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- NOTICE (added by AutoGineer from NOTICE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by AWS.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download amazon-elasticache.zip