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.

rules/naming-arbitrum-terminology.md

View on GitHub
---
title: Use Canonical Arbitrum Terminology
impact: LOW
impactDescription: ensures clarity
tags: naming, terminology, conventions
---

## Use Canonical Arbitrum Terminology

Consistent terminology makes code immediately understandable to Arbitrum developers. Match official SDK naming and documentation.

**Incorrect (non-standard names):**

```typescript
// Bad: Abbreviated or wrong casing
const ticketId: string           // Missing 'retryable'
const msgStatus: number          // Non-standard
import { ERC20Bridger }          // Wrong: it's Erc20Bridger
```

**Correct (canonical terminology):**

```typescript
// Good: Matches SDK and docs
const retryableTicketId: string
const l1ToL2MessageStatus: L1ToL2MessageStatus
import { Erc20Bridger, EthBridger } from '@arbitrum/sdk'
```

| Correct | Incorrect |
|---------|-----------|
| Nitro | nitro, NITRO |
| ArbOS | Arbos, arbOS |
| AnyTrust | Anytrust, anyTrust |
| retryable ticket | retry ticket |
| Erc20Bridger | ERC20Bridger |
| ArbSys | arbsys |

For complete terminology, see [Arbitrum Glossary](https://docs.arbitrum.io/intro/glossary).
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: 198kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall