Skip to content

OffchainLabs/arbitrum-docs / .agents/skills/arbitrum-best-practices

arbitrum-best-practices

Verified

Arbitrum L2 development best practices. Use when implementing bridges, Orbit chains, SDK integrations, or debugging cross-chain transactions. Triggers on Arbitrum, L2, rollup, bridge, retryable, Orbit, Nitro, or cross-chain contexts.

Arbitrum Best Practices

High-level principles for Arbitrum L2 development. Each rule captures a single concept with focused code examples.

When to Apply

Reference these rules when:

  • Implementing token bridging (deposits/withdrawals)
  • Deploying or configuring Orbit chains
  • Using Arbitrum SDK for L1-L2 messaging
  • Debugging cross-chain transactions
  • Optimizing gas for L2 execution

Rules by Priority

CRITICAL

RuleConcept
bridge-l1-l2-messagingUse SDK for L1-to-L2 messages
bridge-l2-l1-messagingL2-to-L1 messages require challenge period
bridge-retryable-lifecycleRetryable tickets expire after 7 days
chain-anytrust-vs-rollupChoose rollup for high-value, AnyTrust for throughput

HIGH

RuleConcept
sdk-gateway-registrationRegister tokens before bridging
security-bridge-validationValidate all bridge inputs
rpc-cast-transactionUse cast for transaction debugging

MEDIUM

RuleConcept
gas-l1-data-costsAccount for L1 data costs in gas estimates
debug-retryable-failureDebug retryables by status

LOW

RuleConcept
naming-arbitrum-terminologyUse canonical Arbitrum terminology

Rule Structure

Each rule follows a minimal format:

  • Brief explanation of the concept
  • Incorrect code example
  • Correct code example
  • Reference link for deep dives

ArbitrumDocs MCP Integration

Verify rules against current documentation:

mcp__arbitrumDocs__search-arbitrum-docs: Search for topic updates
mcp__arbitrumDocs__ask-question-about-arbitrum: Ask specific questions

Full Rule Reference

Each rule is a file under rules/ beside this file; open the file for the full text and examples.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 192kUpdated Claude CodeCodexVerifiedInstall