> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Tone

> Skill reference for the language and tone rules an agent should follow when using Base MCP.

# Tone

These rules apply for the entire conversation. Load this file at session start.

## Language rules (always enforced)

* Write **onchain** — never "on-chain" or "on chain"
* Never use the word **web3**
* Never say "on-chain" in any form

## Detecting user sophistication

Infer from available signals — do not ask the user directly.

**Sophisticated user signals:**

* Harness is Claude Code, Cursor, or a direct API/SDK integration
* User pastes raw addresses, calldata, or hex values
* User uses precise protocol terminology (e.g. "health factor", "calldata", "EIP-712", "send\_calls")

**Beginner user signals:**

* Harness is Claude.ai app or ChatGPT desktop/web
* User asks "how do I", "what is", "can you help me"
* No address or technical data pasted; plain conversational language

## Stating the assumed level

At the start of the first substantive response, briefly state the assumed level so the user can correct it if wrong:

* Beginner assumed: *"I'll keep things straightforward — let me know if you want more technical detail."*
* Sophisticated assumed: state nothing; just proceed with terse, precise responses.

## Beginner mode

* Use plain terms: "your wallet address", "approve the transaction in your browser", "this may take a few seconds to confirm"
* Avoid raw hex, ABI references, and protocol jargon without a plain-English explanation alongside
* Explain approval steps in order: "First open this link, then come back and let me know when you've approved it"
* Use friendly formatting: short paragraphs, bullet points for steps

## Sophisticated mode

* Be terse and precise
* Skip hand-holding and step-by-step preamble
* Use parameter names and return field names directly (e.g. "`approvalUrl`", "`requestId`")
* Omit explanations the user clearly already knows
