feat: add nats skill

[yordis]

Summary

Add comprehensive NATS subject hierarchy design skill to help users architect scalable messaging patterns. The skill guides users through designing subject hierarchies for pub/sub, request/reply, and streaming patterns with proper naming conventions, wildcard strategies, and multi-tenant isolation. Includes 2,878 lines across a main skill workflow (267 lines) and 5 reference documents covering patterns, anti-patterns, JetStream, security, and domain-specific use cases.

Key capabilities:

• Interactive interview to understand requirements (multi-tenancy, regions, persistence)
• 6 proven subject hierarchy patterns (simple domain, multi-region, multi-tenant, event-sourcing, etc.)
• Anti-pattern detection and migration strategies (8 common mistakes with fixes)
• JetStream stream design guidance (retention, consumers, filtering)
• Subject-based authorization and tenant isolation patterns
• Complete worked examples for 5 domains (e-commerce, IoT, SaaS, event-sourcing, agentic AI)

Design decisions:

• Progressive disclosure: Main skill (267 lines) with separate reference docs (2,611 lines total)
• Allowed tools: AskUserQuestion, Write, Read, Shell (includes CLI validation commands)
• Quality checklist with 9 validation points
• Testing section with NATS CLI commands for validation

This follows the TrogonStack skill pattern established by diataxis-gen-readme and gh-enrich-pr-description: concise main workflow with detailed references available on-demand.

Related

• First NATS-related skill in the repository
• Complements existing documentation skills (diataxis) and GitHub workflow skills (gh)
• Part of expanding TrogonStack to cover messaging architecture and event-driven patterns

Changes

New files:

• skills/nats-design-subject/SKILL.md - Main workflow (267 lines)
• skills/nats-design-subject/references/patterns.md - 6 hierarchy patterns (471 lines)
• skills/nats-design-subject/references/anti-patterns.md - 8 common mistakes (519 lines)
• skills/nats-design-subject/references/jetstream.md - Stream design (597 lines)
• skills/nats-design-subject/references/security.md - Authorization patterns (684 lines)
• skills/nats-design-subject/references/use-cases.md - 5 worked examples (406 lines)

Updated files:

• .claude-plugin/marketplace.json - Added nats plugin entry
• README.md - Added NATS plugin to available plugins table

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

This PR introduces a new NATS messaging plugin with comprehensive reference documentation. The plugin is registered in the marketplace, documented in the README, and includes a main skill document plus five detailed reference guides covering design patterns, anti-patterns, security, JetStream strategies, and real-world use cases for NATS subject hierarchy design.

Changes

Cohort / File(s)	Summary
Plugin Registration & Documentation .claude-plugin/marketplace.json, README.md	Added NATS plugin entry to marketplace configuration with name, description, source, and skills declaration. Updated README with plugin descriptions for both gh and nats in the Available Plugins table.
NATS Skill Definition skills/nats-design-subject/SKILL.md	Comprehensive design guidance document outlining interview workflow, pattern selection, segmentation rules, security considerations, JetStream planning, validation templates, and structured reference navigation.
Reference Documentation skills/nats-design-subject/references/patterns.md, anti-patterns.md, jetstream.md, security.md, use-cases.md	Five reference guides covering six design patterns with segmentation strategies, eight anti-patterns with detection and remediation, JetStream configuration patterns and migrations, subject-based security and multi-tenancy models, and five real-world use cases (microservices, IoT, SaaS, event sourcing, AI agents) with cross-references.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

Hopping through hierarchies, subjects in tow, 🐰
NATS patterns blooming, security all aglow,
Five reference guides light the way,
Anti-patterns vanquished, JetStream at play,
Our warren's pub/sub thrives today! 🎉

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch add-nats-skill

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}