Skip to content
cccskills
FreePublished on GitHub

arbitrum-best-practices

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.

The English summary is being prepared. Showing the original description.

OffchainLabs/arbitrum-docs252 stars(GitHub 252 + cccskills 0)

Run score Not tested

See how to install

Files included (11)

  • SKILL.md2.1 KB
  • rules/bridge-l1-l2-messaging.md1.3 KB
  • rules/bridge-l2-l1-messaging.md1.3 KB
  • rules/bridge-retryable-lifecycle.md1.2 KB
  • rules/chain-anytrust-vs-rollup.md1.3 KB
  • rules/debug-retryable-failure.md1.5 KB
  • rules/gas-l1-data-costs.md1.1 KB
  • rules/naming-arbitrum-terminology.md1.1 KB
  • rules/rpc-cast-transaction.md1.2 KB
  • rules/sdk-gateway-registration.md1.3 KB
  • rules/security-bridge-validation.md1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Create or improve lightweight, brand-consistent SVG concept diagrams for the Arbitrum docs, using the official Google Drive infographic asset kit as the palette/style source. Use when asked to "make a diagram more efficient", replace a bloated haw-*.svg (draw.io PNG-in-SVG exports), replace an ASCII / box-drawing diagram in an MDX page with a real image, author a new concept diagram for content/docs/how-arbitrum-works or similar, or build a diagram from the Arbitrum brand assets. Hand-authored lean vector SVG — not Mermaid, not a full Excalidraw/draw.io pipeline.

The English summary is being prepared. Showing the original description.

OffchainLabs/arbitrum-docs252Updated Oct 24, 2026

Use when asked to rebrand, restyle, re-pace, resize, or re-render an existing explainer video, when a video's labels are baked-in raster pixels that cannot be edited, or when building a new animated explainer for the Arbitrum docs from a prompt or a doc section.

The English summary is being prepared. Showing the original description.

OffchainLabs/arbitrum-docs252Updated Oct 24, 2026

cast

Free

Foundry's cast CLI for Ethereum interactions. Use when querying blockchain data, calling contracts, sending transactions, encoding/decoding data, or debugging on-chain issues. Triggers on "cast", "get balance", "call contract", "decode calldata", "check tx", "get block".

The English summary is being prepared. Showing the original description.

OffchainLabs/arbitrum-docs252Updated Oct 24, 2026

Run full documentation quality audit, covering sidebar orphans, unused-file review, MDX structure, internal links, glossary references, contract addresses, variables, formatting, frontmatter, tests, and types. Triggers on "audit docs", "check docs quality", "find problems", "content audit".

The English summary is being prepared. Showing the original description.

OffchainLabs/arbitrum-docs252Updated Oct 24, 2026

LLM Utility: Generate minimal project context map before starting any workflow. ALWAYS run this first at session start, before /prd, before /implement, or after context loss. Triggers on 'context prep', 'orient me', 'start', 'new session'.

The English summary is being prepared. Showing the original description.

OffchainLabs/arbitrum-docs252Updated Oct 24, 2026

Create new Arbitrum development rules following best practices format. Use when capturing a reusable pattern, common mistake, or architectural decision. Triggers on "create rule", "add rule", "new rule", "document this pattern".

The English summary is being prepared. Showing the original description.

OffchainLabs/arbitrum-docs252Updated Oct 24, 2026

See all skills by OffchainLabs

Report a problem with this skill