streamnative-agent-skills

StreamNative Agent Skills

Agent skills that teach any skill-compatible AI agent how to manage StreamNative Cloud resources through StreamNative Cloud remote MCP tools or the snctl CLI. Distributed as the streamnative-agent-skills plugin. Built to the agentskills spec; installable as a Claude Code plugin or as portable skill directories in Cursor, Gemini CLI, OpenCode, Goose, Codex, and more.

At a glance: 7 domain skills · 48 guided workflows · 33 reference docs · 22 starter YAML manifests · 7 snctl smoke walkthroughs · 7 remote MCP smoke walkthroughs · 16 machine-readable smoke specs.

---

Quick start

After installing the plugin and setting up snctl, just ask your agent in natural language:

Create a serverless Pulsar instance named events in us-east-1.

Give me a service account with admin access and export its key.

Create a 3-partition Kafka topic user-events and produce 10 test messages.

Set up BYOC to my AWS account 123456789012 with a VPC in eu-west-1.

Deploy a Pulsar Function from word-count.jar that reads from topic in and writes to out.

The right skill activates based on the request. You never invoke skills explicitly — the agent picks.

---

Prerequisites

Pick one execution base:

1. Remote MCP (preferred when your agent exposes MCP tools): connect the StreamNative Cloud remote MCP server with org-level Cloud tools and/or fixed cluster-level Pulsar/Kafka tools enabled. Remote MCP server is public preview and disabled by default; org-level MCP and cluster-level MCP are both disabled by default and must be enabled separately in StreamNative Cloud UI. New clusters also start with cluster-level MCP disabled. The skills use sncloud_*, pulsar_*, and kafka_* MCP tools when available.
2. snctl fallback/baseline: install and authenticate snctl.

   curl -fsSL https://downloads.streamnative.cloud/snctl/install.sh | sh
   

   Or via Homebrew:

   brew install streamnative/streamnative/snctl
   

   Authenticate:
   • Interactive: snctl auth login
   • Automation: snctl auth activate-service-account --key-file ./key.json

Remote MCP cannot cover every local credential flow yet; keep snctl available for API keys, Cloud Secrets, service-account key export/activation, and local config/token tasks.

---

Install

Claude Code (plugin — recommended)

/plugin marketplace add streamnative/streamnative-agent-skills
/plugin install streamnative-agent-skills

Registers all seven currently documented skills at once. Plugin metadata: .claude-plugin/plugin.json.

Other skill-compatible agents

Clone the repo and point your agent at the relevant skills/<skill-name>/ directory. Each skill is a self-contained agentskills package.

git clone https://github.com/streamnative/streamnative-agent-skills.git
# Follow your tool's "add skill" flow (Cursor, Gemini CLI, OpenCode, Goose, Codex, etc.)

Selective install

Copy a single skills/<skill-name>/ directory into the agent's skills directory.

---

What's inside (the 7 skills)

Skill	Workflows	Covers	Activates on
cloud-core	7	Install, auth, config, context, API resources, logs	"install snctl", "log in", "switch org", "service account"
byoc-infrastructure	6	Cloud connections, environments, tiered-storage volumes	"BYOC", "my AWS/GCP/Azure account", "VPC CIDR", "tiered storage"
pulsar-clusters	6	Pulsar instance/cluster/gateway — serverless, dedicated, BYOC, BYOC Pro	"create cluster", "pulsarinstance", "scale brokers", "gateway"
kafka-clusters	7	Kafka Instance/KafkaCluster — dedicated, BYOC, BYOC Pro, AuthV2 contexts	"kafkacluster", "Kafka cluster", "throughput unit", "Kafka service context"
identity	7	Users, service accounts, roles, API keys, secrets, OIDC, identity pools	"grant access", "API key", "role binding", "OIDC", "federated login"
pulsar-admin	8	Tenants, namespaces, topics, subscriptions, Pulsar Functions	"tenant", "namespace", "topic", "produce/consume", "Pulsar function"
kafka-admin	7	Kafka topics, groups, partitions, Schema Registry, Kafka Connect	"Kafka topic", "consumer group", "schema registry", "Kafka Connect"

---

Features

Execution bases