celestia-engineering

Celestia/Cosmos SDK development workflows for Claude Code with repo-aware context detection.

New in v2.3.0: Workflows now detect repository type via go.mod and automatically adjust agent selection. Non-Cosmos SDK repos (celestia-node, rsmt2d, etc.) will skip Cosmos-specific agents and run general-purpose reviewers only.

Components

Type	Count	Description
Agents	13	Specialized code reviewers
Commands	8	Workflow orchestration
Skills	3	Development patterns

Agents

Cosmos SDK Reviewers

Agent	Purpose
cosmos-sdk-reviewer	Proto definitions, keeper patterns, typed events, tests
cosmos-proto-expert	gRPC/protobuf design, backwards compatibility
cosmos-security-auditor	Security vulnerabilities, authorization, IBC safety
cosmos-test-reviewer	Test coverage, test patterns, integration tests

Cosmos Specialists

Agent	Purpose
cosmos-ibc-expert	IBC packet handling, channel lifecycle, cross-chain security
cosmos-state-machine-reviewer	ABCI lifecycle, determinism, consensus safety
cosmos-upgrade-validator	Chain upgrades, state migrations, version compatibility
cosmos-gas-optimizer	Gas efficiency, storage patterns, computation optimization

General Purpose Reviewers

Agent	Purpose
security-sentinel	Input validation, authorization, OWASP vulnerabilities
performance-oracle	Algorithmic complexity, caching, resource usage
data-integrity-guardian	State consistency, migrations, genesis handling
code-simplifier	Unnecessary complexity, over-engineering, redundant patterns

Cross-Chain

Agent	Purpose
hyperlane-expert	Hyperlane integration, ISM configuration, cross-chain messaging

Commands

Core Workflows

Command	Purpose
/celestia-engineering:workflows:review	Intelligent code review with conditional agent selection
/celestia-engineering:workflows:plan	Create implementation plans for modules
/celestia-engineering:workflows:work	Execute plans with quality gates
/celestia-engineering:workflows:compound	Document solved problems

Advanced Workflows

Command	Purpose
/celestia-engineering:workflows:deepen-plan	Enhance plans with parallel research
/celestia-engineering:workflows:triage	Categorize and prioritize findings
/celestia-engineering:workflows:resolve_pr_parallel	Resolve PR comments in parallel
/celestia-engineering:workflows:plan_review	Multi-agent plan review before implementation

Skills

Skill	Purpose
cosmos-patterns	Module structure, proto conventions, keeper patterns
git-worktree	Isolated parallel development without branch switching
update-plugin	Update installed plugin with latest changes from local repo

Installation

Quick Install (Recommended)

curl -sSL https://raw.githubusercontent.com/celestiaorg/celestia-engineering/main/install.sh | bash

Then restart Claude Code.

Manual Installation

Click to expand manual installation steps

Step 1: Set up the marketplace

Create the marketplace directory structure:

# Create marketplace directories
mkdir -p ~/.claude/plugins/marketplaces/celestia-marketplace/plugins
mkdir -p ~/.claude/plugins/marketplaces/celestia-marketplace/.claude-plugin

# Clone the plugin
git clone https://github.com/celestiaorg/celestia-engineering.git \
  ~/.claude/plugins/marketplaces/celestia-marketplace/plugins/celestia-engineering

# Create marketplace.json
cat > ~/.claude/plugins/marketplaces/celestia-marketplace/.claude-plugin/marketplace.json << 'EOF'
{
  "name": "celestia-marketplace",
  "owner": {
    "name": "Celestia",
    "url": "https://github.com/celestiaorg"
  },
  "metadata": {
    "description": "Celestia development plugins for Claude Code",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "celestia-engineering",
      "description": "Celestia/Cosmos SDK development workflows. 12 agents, 8 commands, 2 skills.",
      "version": "2.0.0",
      "author": { "name": "Celestia Team" },
      "homepage": "https://github.com/celestiaorg/celestia-engineering",
      "tags": ["celestia", "cosmos-sdk", "blockchain", "go", "ibc", "hyperlane"],
      "source": "./plugins/celestia-engineering"
    }
  ]
}
EOF

Step 2: Register the marketplace

Add to ~/.claude/plugins/known_marketplaces.json:

{
  "celestia-marketplace": {
    "source": {
      "source": "github",
      "repo": "celestiaorg/celestia-engineering"
    },
    "installLocation": "/Users/YOUR_USERNAME/.claude/plugins/marketplaces/celestia-marketplace",
    "lastUpdated": "2026-01-13T00:00:00.000Z"
  }
}

Step 3: Create the cache

# Create cache directory
mkdir -p ~/.claude/plugins/cache/celestia-marketplace/celestia-engineering/2.0.0

# Copy plugin to cache
cp -r ~/.claude/plugins/marketplaces/celestia-marketplace/plugins/celestia-engineering/* \
  ~/.claude/plugins/cache/celestia-marketplace/celestia-engineering/2.0.0/
cp -r ~/.claude/plugins/marketplaces/celestia-marketplace/plugins/celestia-engineering/.claude-plugin \
  ~/.claude/plugins/cache/celestia-marketplace/celestia-engineering/2.0.0/

Step 4: Register the plugin

Add to ~/.claude/plugins/installed_plugins.json under "plugins":

"celestia-engineering@celestia-marketplace": [
  {
    "scope": "user",
    "installPath": "/Users/YOUR_USERNAME/.claude/plugins/cache/celestia-marketplace/celestia-engineering/2.0.0",
    "version": "2.0.0",
    "installedAt": "2026-01-13T00:00:00.000Z",
    "lastUpdated": "2026-01-13T00:00:00.000Z"
  }
]

Add to ~/.claude/settings.json under "enabledPlugins":

"celestia-engineering@celestia-marketplace": true

Step 5: Restart Claude Code

# Exit and restart Claude Code
exit
claude

Verify installation

Run /plugin to see if celestia-engineering@celestia-marketplace is listed and enabled.

Then try:

/celestia-engineering:workflows:review --help

Usage

Code Review

/celestia-engineering:workflows:review 123

Reviews PR #123 using intelligent agent selection. The workflow first detects repository type via go.mod, then selects appropriate agents.

Repository Detection:

Module Path Contains	Type	Agents Used
celestia-app, rollkit, cosmos-sdk	Cosmos SDK	Full agent suite
celestia-node	DA Layer	General-purpose only
rsmt2d	Crypto Library	General-purpose only
(other)	Generic Go	General-purpose only

Cosmos SDK repos - Always run:

• cosmos-sdk-reviewer - Core SDK patterns
• security-sentinel - General security
• code-simplifier - Complexity and over-engineering

Non-Cosmos SDK repos - Always run:

• security-sentinel - General security
• code-simplifier - Complexity and over-engineering

Cosmos SDK repos - Conditional:

Agent	Triggers When
cosmos-proto-expert	*.proto files changed
cosmos-test-reviewer	*_test.go files changed
cosmos-ibc-expert	IBC code (OnRecvPacket, channeltypes)
cosmos-state-machine-reviewer	ABCI code (BeginBlock, EndBlock)
cosmos-upgrade-validator	Upgrade/migration code
cosmos-gas-optimizer	Keeper/storage operations
data-integrity-guardian	Genesis or migration code

All repos - Conditional:

Agent	Triggers When
hyperlane-expert	Hyperlane imports (Mailbox, ISM)
performance-oracle	Complex iterations
data-integrity-guardian	State mutations, migrations

The summary report shows repository context, which agents ran, and why.

Plan an Implementation

/celestia-engineering:workflows:plan "Add a burn module that allows users to burn TIA"

Creates a detailed implementation plan. For Cosmos SDK repos, includes proto definitions, keeper design, and module registration. For non-Cosmos repos, provides generic Go implementation templates.

Review a Plan

/celestia-engineering:workflows:plan_review plan.md

Multi-agent review of the plan before implementation.

Deepen a Plan

/celestia-engineering:workflows:deepen-plan plan.md

Enhance plan with research and best practices.

Execute a Plan

/celestia-engineering:workflows:work plan.md

Implements the plan with continuous testing.

Resolve PR Comments

/celestia-engineering:workflows:resolve_pr_parallel 123

Address all review comments in parallel.

Triage Findings

/celestia-engineering:workflows:triage review

Categorize and prioritize review findings.

Document a Solution

/celestia-engineering:workflows:compound

Documents the recently solved problem.

Customization

Add a new agent

1. Create agents/review/your-agent.md
2. Follow the format in existing agents
3. Update README.md counts

Add to review workflow

1. Edit commands/workflows/review.md
2. Add your agent to parallel_tasks or conditional_agents

Add patterns

1. Add to skills/cosmos-patterns/references/
2. Update skills/cosmos-patterns/SKILL.md

Contributing

1. Fork the repository
2. Make changes
3. Update version in .claude-plugin/plugin.json
4. Update CHANGELOG.md
5. Submit PR

License

MIT