A collection of skills for AI coding agents working with Upstash SDKs. Skills are packaged instructions and resources that extend agent capabilities.

This repo works as an Agent Skills repo, a Claude Code plugin, and a Cursor plugin.

# Add the marketplace
/plugin marketplace add upstash/skills

# Install the plugin
/plugin install upstash@upstash

# Add the marketplace
/plugin marketplace add upstash/skills

# Install the plugin
/plugin install upstash@upstash

npx ctx7 skills install upstash/skills

npx skills add upstash/skills

For full access to Upstash APIs (create databases, publish messages, query vectors, etc.), you can also set up the @upstash/mcp-server:

claude mcp add upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]
    }
  }
}

1. Edit the files in the individual skill folder (e.g. skills/upstash-qstash-js/).
2. Run npm run build to regenerate skills/upstash/.
3. Commit both the source changes and the regenerated output.

1. Create a new folder under skills/ (e.g. skills/upstash-redis-js/).
2. Add a SKILL.md with the standard frontmatter (name and description) and any supporting files.
3. Run npm run build — the new skill will be picked up automatically.
4. Commit everything.

The frontmatter and introductory text for skills/upstash/SKILL.md comes from scripts/header.md. Edit that file, then run npm run build.

When making a release, bump the version field in both .claude-plugin/plugin.json and .cursor-plugin/plugin.json.

The GitHub Actions workflow (.github/workflows/check.yml) runs npm run check on every push and PR. If you forget to run npm run build before pushing, CI will fail.