К основному содержанию
скилл CX Codex

nats — скилл для Claude Code: возможности и установка

Скилл для Claude Code объясняет Core NATS, JetStream и обмен запросами с ответом. Подключается к вопросам о NATS, шаблонах subject и связи микросервисов.

MIT 101 установок ★ 50 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add claude-dev-suite/claude-dev-suite --skill nats -a claude-code
Открыть на GitHub

Что делает nats

Скилл помогает проектировать обмен сообщениями через NATS и разбирать его ключевые режимы. Он охватывает публикацию и подписку, группы очередей, шаблоны subject с подстановочными знаками и схему request/reply. Примеры даны для Node.js, Python и Go.

Core NATS доставляет сообщения без сохранения и повторного воспроизведения, а JetStream добавляет персистентность и возможность replay. Для JetStream сервер запускают с флагом -js; пример конфигурации Docker Compose использует порты 4222 и 8222. В запросах нужен тайм-аут, иначе они могут зависнуть.

Какие задачи решает

  • настроить публикацию и подписку на сообщения NATS
  • подобрать subject-шаблон для фильтрации событий
  • связать сервисы через request/reply
  • выбрать между Core NATS и JetStream

Примеры запросов агенту

  • Покажи, как настроить request/reply в NATS на Python.
  • Объясни, когда для событий нужен JetStream, а когда достаточно Core NATS.
  • Как подписаться на orders.* и распределить сообщения между обработчиками?

Как установить nats

1Через Skills CLI (Vercel)

npx skills add claude-dev-suite/claude-dev-suite --skill nats -a claude-code

2Вручную: положить файлы

~/.claude/skills/nats/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nats/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о nats

Как установить nats в Claude Code?

Выполни npx skills add claude-dev-suite/claude-dev-suite --skill nats -a claude-code. Файл скилла находится по пути ~/.claude/skills/nats/SKILL.md.

Что делает nats?

Скилл объясняет Core NATS, JetStream и шаблоны обмена сообщениями. В нём есть примеры публикации, подписки и request/reply для Node.js, Python и Go.

Чем Core NATS отличается от JetStream?

Core NATS не сохраняет сообщения и доставляет их не более одного раза. JetStream поддерживает сохранение и повторное воспроизведение, а доставка может происходить как минимум один раз.

Исходный текст

SKILL.md · MIT
---
name: nats
description: |
  NATS cloud-native messaging system. Covers Core NATS, JetStream persistence,
  and request/reply patterns. Use for lightweight, high-performance
  microservices communication.

  USE WHEN: user mentions "nats", "jetstream", "cloud-native messaging", "request/reply", "subject wildcards", asks about "lightweight messaging", "microservices communication", "nats streaming"

  DO NOT USE FOR: complex routing - use `rabbitmq`; AWS-native - use `sqs`; Azure-native - use `azure-service-bus`; JMS compliance - use `activemq`; persistent queues only - use dedicated broker
allowed-tools: Read, Grep, Glob, Write, Edit
---
# NATS Core Knowledge

> **Full Reference**: See [advanced.md](advanced.md) for JetStream patterns (Node.js, Java), security configuration, TLS setup, and clustering.

> **Deep Knowledge**: Use `mcp__documentation__fetch_docs` with technology: `nats` for comprehensive documentation.

## Quick Start (Docker)

```yaml
# docker-compose.yml
services:
  nats:
    image: nats:latest
    ports:
      - "4222:4222"   # Client
      - "8222:8222"   # Monitoring
    command: "-js -m 8222"  # Enable JetStream
```

## Core Concepts

| Feature | Core NATS | JetStream |
|---------|-----------|-----------|
| Persistence | No | Yes |
| Delivery | At-most-once | At-least-once |
| Replay | No | Yes |
| Consumer Groups | Queue Groups | Consumer Groups |

## Subject Patterns

```
orders.created     → Specific subject
orders.*           → orders.created, orders.updated (single wildcard)
orders.>           → orders.created, orders.us.east (multi wildcard)
```

## Core NATS (Node.js)

```typescript
import { connect, StringCodec } from 'nats';

const nc = await connect({ servers: 'localhost:4222' });
const sc = StringCodec();

// Simple publish
nc.publish('orders.created', sc.encode(JSON.stringify(order)));

// Subscribe
const sub = nc.subscribe('orders.*');
for await (const msg of sub) {
  const order = JSON.parse(sc.decode(msg.data));
  console.log(`Received on ${msg.subject}:`, order);
}

// Queue group (load balancing)
const qsub = nc.subscribe('orders.process', { queue: 'workers' });

// Request/Reply
const response = await nc.request('orders.validate', sc.encode(JSON.stringify(order)), {
  timeout: 5000,
});
const result = JSON.parse(sc.decode(response.data));

await nc.drain();
```

## Core NATS (Python)

```python
import nats
import json
import asyncio

async def main():
    nc = await nats.connect("nats://localhost:4222")

    # Publish
    await nc.publish("orders.created", json.dumps(order).encode())

    # Subscribe
    async def message_handler(msg):
        order = json.loads(msg.data.decode())
        print(f"Received: {order}")

    await nc.subscribe("orders.*", cb=message_handler)

    # Request/Reply
    response = await nc.request("orders.validate",
                                json.dumps(order).encode(),
                                timeout=5)
    result = json.loads(response.data.decode())

    await nc.drain()

asyncio.run(main())
```

## Core NATS (Go)

```go
nc, _ := nats.Connect(nats.DefaultURL)
defer nc.Drain()

// Publish
body, _ := json.Marshal(order)
nc.Publish("orders.created", body)

// Subscribe
nc.Subscribe("orders.*", func(msg *nats.Msg) {
    var order Order
    json.Unmarshal(msg.Data, &order)
    processOrder(order)
})

// Queue group
nc.QueueSubscribe("orders.process", "workers", func(msg *nats.Msg) {
    // Load balanced
})

// Request/Reply
response, _ := nc.Request("orders.validate", body, 5*time.Second)
```

## When NOT to Use This Skill

- Long-term event replay required - Kafka provides better retention
- Complex routing patterns - RabbitMQ exchanges are more flexible
- JMS compliance needed - Use ActiveMQ
- AWS-native integration - SQS integrates better

## Anti-Patterns

| Anti-Pattern | Why It's Bad | Solution |
|--------------|--------------|----------|
| Core NATS for critical data | Fire-and-forget | Use JetStream for persistence |
| No subject hierarchy | Hard to filter | Use dot-separated subjects |
| No timeout on requests | Hanging requests | Always set timeout |
| Large payloads | Network strain | Keep messages small |
| Single server in production | No HA | Deploy 3+ server cluster |

## Quick Troubleshooting

| Issue | Likely Cause | Fix |
|-------|--------------|-----|
| Messages not received | Wrong subject | Verify subject name, check wildcards |
| Request timeout | No responders | Verify responders exist |
| JetStream errors | Not enabled | Start server with `-js` flag |
| Consumer lag growing | Slow processing | Add consumers or optimize |
| ACK timeout | Processing too slow | Increase ack_wait |

## Production Checklist

- [ ] TLS enabled
- [ ] Authentication configured
- [ ] Authorization (permissions)
- [ ] JetStream replicas >= 3
- [ ] Stream limits configured
- [ ] Consumer max_deliver set
- [ ] Ack timeout configured
- [ ] Monitoring dashboards
- [ ] Cluster health checks

## Reference Documentation

Available topics: `basics`, `jetstream`, `patterns`, `production`

© claude-dev-suite · MIT · claude-dev-suite/claude-dev-suite

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
nats-expert 0xfurai Субагент nats-expert для Claude Code проектирует и разбирает NATS: топики, подписки, кластеры, безопасность и сбои доставки. Разбирает задачи с брокером сообщений. CX Codex ★ 1 029звёзд репо microsoft-guide JosiahSiegel Скилл microsoft-guide для Claude Code помогает находить рекомендации Microsoft по архитектуре .NET-микросервисов. Он включается при вопросах о DDD, CQRS, интеграционных событиях и развёртывании. CX Codex +1 157установок cloud-solution-architect microsoft Скилл cloud-solution-architect превращает ИИ-агента в архитектора облачных решений по стандартам Azure Architecture Center. Помогает выбирать архитектурные стили и проверять дизайн систем по правилам WAF. CX Codex +1 117установок azure-servicebus-py Microsoft Скилл azure-servicebus-py помогает писать код на Python для Azure Service Bus: отправлять и получать сообщения через очереди, топики и подписки. Пригодится при добавлении обмена сообщениями в приложение. CX Codex +1 1установок microservices-patterns Seth Hobson Скилл microservices-patterns помогает проектировать микросервисные системы: выделять границы сервисов, выбирать обмен сообщениями и добавлять паттерны устойчивости. CX Codex +1 13 176установок workflow-orchestration-patterns Seth Hobson Скилл workflow-orchestration-patterns помогает проектировать долгие и распределённые процессы на Temporal: разделять workflow и activity, сохранять состояние и восстанавливаться после сбоев. CX Codex +1 12 053установок

Из того же набора14

Весь набор →
email-sending Скилл email-sending для Claude Code подключает отправку транзакционных писем, шаблоны и почтовые сервисы. Отправляет welcome-письма, сбросы пароля и уведомления. CX Codex +1 188установок cron-scheduling Скилл cron-scheduling для Claude Code помогает задавать cron-расписания и планировать фоновые задачи в Node.js, Java и Python. Описывает периодические запуски и распределённое планирование. CX Codex +1 162установок iec61131 Разбирает языки PLC, типы данных и организацию программ по IEC 61131-3. Помогает обсуждать стандарты и обмен проектами между платформами. CX Codex +1 154установок plsql Oracle PL/SQL — процедуры, функции, пакеты, триггеры, курсоры, коллекции и обработка исключений. CX Codex +1 106установок socket-io Добавляет в агент паттерны для работы с Socket.IO: комнаты, авторизацию через middleware, типизацию в TypeScript и масштабирование через Redis. CX Codex +1 106установок sonarqube Настраивает проверку качества кода через SonarQube или SonarCloud. Помогает прописать quality gates, файл sonar-project.properties и шаги для CI/CD. CX Codex +1 106установок spring-webflux Помогает писать реактивный код на Spring WebFlux в Spring Boot 3.x. Подключается к задачам с Mono, Flux, WebClient и R2DBC. CX Codex +1 102установок sqlserver Справочник по диалекту Microsoft SQL Server: типы данных, даты, строки, JSON и автоинкремент. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой