Aerospike Agent Skills
One Aerospike skill teaches an agent to run the database in Docker, write client code on the official SDKs and design the schema
- 20 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The first run walks the agent through Docker commands that start the database container and open ports 3000–3002
- The code and schema rules affect how the agent writes data to the database, although the skill itself does not connect to a cluster
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/aerospike-agent-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The first run walks the agent through Docker commands that start the database container and open ports 3000–3002
- The code and schema rules affect how the agent writes data to the database, although the skill itself does not connect to a cluster
This is third-party code. Review the repository files before installing.
What it does
The repository compiles three authoring skills into one published skill, `aerospike`. The first part, getting-started, brings up a local instance in Docker: the image, ports 3000–3002, the configuration, the `test` namespace, a log check and a first write and read. The second, development, edits client code: collection data types, expressions, secondary indexes, batch and scan operations, policies and connection pools. The third, data-modeling, designs a schema from requirements or reviews an existing one. The rules live in the `references/` folder, and the whole folder must be installed, or the files named in `SKILL.md` will be missing. The skill carries a list of mistakes that models often make: wrong namespace and port names, invented REST endpoints, TTL without `nsup-period` enabled. The scope is the core database, without Aerospike Graph.
Who it is for. Developers who bring up Aerospike for the first time, write a client in Python, Node.js, Go, Java or C#, or consider the database as a persistent replacement for Redis.
Good fit when
- You need a working Aerospike instance in Docker on a laptop and a verified first write
- You review client code: the skill looks for a client created per request, extra policies and writes without `replace`
- The data schema for user profiles or a feature store is designed from scratch from requirements
- Records must expire, and the agent turns on `nsup-period` and leaves the test-only flag alone
- Redis or Memcached is being replaced by a database with disk persistence, and you need to plan how to move the data
Not a fit when
- You work with Aerospike Graph: the skill covers the core database only
- You need cluster topology, sizing, XDR, backup or Kubernetes: the skill leaves these to the operations documentation
- The server is older than 7.0: the verified range starts at 7.0
Example request
Start Aerospike in Docker, use the test namespace, write a record with a TTL and read it back with a Python clientLimitations
- The whole skill folder must be installed with `references/`, and `SKILL.md` alone is not enough.
- The install command takes the address of the `compiled-skills/aerospike` directory, and the repository root address does not work: the tool would install the uncompiled authoring folders.
- The skill was verified on servers 7.0 and newer.
- Community Edition has no authentication, so the skill does not generate username and password code for it.
- Cluster operations, XDR and backup are outside the skill.
How to disable. Delete the `aerospike` folder from the agent's skills directory. A container the skill helped start is stopped with `docker stop` and the container name.
FAQ
How do I install the Aerospike skill in Claude Code?
Run `npx skills add https://github.com/aerospike/agent-skills/tree/main/compiled-skills/aerospike`. Do not substitute the repository root. For Gemini CLI add `-a gemini-cli` to the command, and the skill lands in `.agents/skills/aerospike/`.
Which Docker image does the skill use by default?
`aerospike/aerospike-server`, which is Community Edition. Enterprise is taken only when needed: since 6.1.0 its image has a built-in evaluation key for a single node.
Why is a write with a TTL rejected?
By default `nsup-period` is 0, and the process that removes expired records does not run. For TTL set `nsup-period` above zero. The documentation treats the `allow-ttl-without-nsup` flag as test-only.
Which SDKs fit?
The official clients for Python, Node.js, Go, Java and C#. The skill teaches the `aerospike.client` factory in Python and `require('aerospike')` in Node.js instead of inventing package names that do not exist.
Does the skill connect to a production cluster?
No. The skill works with a local Docker instance and with code. For production deployment and operations it points to the official Aerospike documentation.
Discussion
No questions or reviews yet.
Related
SkillsA template for data scientists: AGENTS.md, CLAUDE.md and skills for Python, SQL, Polars and model diagnostics.
Neo4j skills for agents: Cypher queries, graph modeling, drivers, import, GraphRAG, GDS and Aura provisioning
Official Elastic skills for Elasticsearch, Kibana, Observability, Security and Elastic Cloud: ES|QL, indices, dashboards, alert triage
Official Tinybird skills: datafile and SQL rules, the tb CLI, and the TypeScript and Python SDKs
A Neon skill with Postgres 14 to 18 guidance: schema design, indexes, query tuning, migrations and common pitfalls.
Official Databricks skills guide coding agents through data work, Lakeflow jobs and resource deployment on the platform.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Aerospike Agent Skills (this card) | yes | 20 | ||
| Redis MCP Server | yes | not required | 642 | an MCP server that reads and writes Redis data, while this skill teaches code and schema design for Aerospike |
| PlanetScale Database Skills | yes | 739 | skills for PlanetScale and other database technologies, while here it is one skill for the Aerospike core only |
README in short
The front page explains the repository layout: three authoring skills in `skills/` and one compiled skill in `compiled-skills/`. A table shows how to connect it to different tools. Next come two paths without AI, a first run and development, a first-hour checklist and the maintenance rules.