Merge origin/master into feat/agent-file

Resolve claude.md conflict by keeping the detailed version.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: soheimam

.claude/skills/doc-feedback.md

@@ -0,0 +1,42 @@
+---
+name: reviewing-documentation
+description: Reviews documentation for quality, consistency, and style guide adherence. Use when reviewing changed docs or before publishing new content.
+---
+
+# Documentation Feedback
+
+## Workflow
+
+1. **Get files to review**
+   ```bash
+   git diff --name-only HEAD -- '*.mdx'
+   git diff --name-only master...HEAD -- '*.mdx'
+   ```
+   If `$ARGUMENTS` provided, review that path instead.
+
+2. **Run linter first**
+   ```bash
+   node scripts/lint-mdx.js $ARGUMENTS
+   ```
+
+3. **Review against style guide** — See [content-instructions.md](../../content-instructions.md)
+
+4. **Provide feedback** per file:
+   - What's working well
+   - Specific suggestions with line references
+   - Linter issues (if any)
+
+5. **Offer to fix** issues if requested
+
+## Review checklist
+
+```
+Review Progress:
+- [ ] Terminology consistent
+- [ ] Code examples complete and runnable
+- [ ] No placeholder values (foo, bar, example.com)
+- [ ] Headings descriptive and keyword-rich
+- [ ] Content scannable (headings, lists, white space)
+- [ ] Active voice, second person
+- [ ] Troubleshooting included where appropriate
+```

.claude/skills/lint.md

@@ -0,0 +1,25 @@
+---
+name: linting-mdx
+description: Runs deterministic MDX linter and helps fix formatting, structure, and Mintlify component issues. Use when checking documentation quality or before committing changes.
+---
+
+# Lint MDX
+
+Run the linter:
+
+```bash
+node scripts/lint-mdx.js $ARGUMENTS
+```
+
+Arguments: (none) = changed files, `all` = everything, or specify a path.
+
+## Workflow
+
+1. Run linter, present results
+2. If errors found, offer to fix them
+3. Prioritize errors over warnings
+
+## References
+
+- [mintlify-reference.md](../../mintlify-reference.md) — component syntax
+- [content-instructions.md](../../content-instructions.md) — writing guidelines

claude.md

@@ -1,30 +1,64 @@
-# Documentation Repository
+# Base Documentation
 
-## Stack
-- Mintlify for documentation site
-- MDX files in `docs/` folder
-- Storybook for component demos
+Technical documentation for Base (Ethereum L2). Built with Mintlify.
 
-## Git
-- Primary branch: `master`
+## Commands
 
-## Key References
-- `mintlify-reference.md` — Mintlify component syntax and usage
-- `content-instructions.md` — Content guidelines
-- `global-tone-voice.mdx` — Tone and voice standards
-- `docs.json` — Site navigation and configuration
+| Command | Description |
+|---------|-------------|
+| `mintlify dev` | Local dev server |
+| `/lint` | Lint MDX files and fix issues |
+| `/doc-feedback` | Review content quality |
 
-## Conventions
-- Use American English spelling
-- Sentence case for headings
-- All images wrapped in `<Frame>`
-- Code blocks must specify a language
-- Use Mintlify callouts sparingly (`<Note>`, `<Tip>`, `<Warning>`, `<Info>`, `<Check>`)
+## Structure
 
-## Commands
-- `/lint` — Check MDX formatting and Mintlify component usage
+```
+docs/
+├── get-started/      # Intro, quickstarts
+├── base-chain/       # Network, nodes, tools
+├── base-account/     # Smart Wallet SDK
+├── base-app/         # Agent development
+├── mini-apps/        # MiniKit guides
+├── onchainkit/       # React components (versioned)
+├── cookbook/         # Tutorials
+├── learn/            # Solidity, Ethereum basics
+├── images/           # Assets by topic
+├── snippets/         # Reusable MDX components
+└── docs.json         # Navigation config
+```
+
+## Content Rules
+
+**Frontmatter** (required):
+```yaml
+---
+title: "Keyword-rich title"
+description: "Value description"
+---
+```
+
+**Writing**: American English, sentence case headings, second person ("you"), active voice.
+
+**Code blocks**: Always specify language. Add filename or title. Use `highlight={}` for emphasis.
+
+**Components**: See [mintlify-reference.md](mintlify-reference.md) for syntax.
+
+**Images**: Wrap in `<Frame>`, include `alt` attribute.
+
+## Navigation
+
+Edit `docs.json` to add/remove pages. Add redirects when removing pages.
+
+## References
+
+| File | Purpose |
+|------|---------|
+| [content-instructions.md](content-instructions.md) | Writing guidelines |
+| [mintlify-reference.md](mintlify-reference.md) | Component syntax |
+| [scripts/README.md](scripts/README.md) | Linter usage |
 
 ## Before Committing
-- Run `/lint` and fix any errors
-- If removing docs, add redirects in `docs.json`
-- Ensure all internal links are valid
+
+1. Run `/lint` and fix errors
+2. Add redirects for removed pages
+3. Verify links work