Skip to content
Back to search

lean-surf

MarketplaceWorks with Claude CodeGitHub

Token-lean web browsing for agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pixel-noir--lean-surf/badge.svg)](/listings/pixel-noir--lean-surf)

HTML

<a href="/listings/pixel-noir--lean-surf"><img src="/api/listings/pixel-noir--lean-surf/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code** (as a plugin):

/plugin marketplace add pixel-noir/lean-surf
/plugin install lean-surf@lean-surf

**Any agent that reads `SKILL.md`**:

git clone https://github.com/pixel-noir/lean-surf.git
cp -r lean-surf/skills/lean-surf ~/.claude/skills/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "name": "lean-surf",
  3. "description": "Token-lean web browsing for agents.",
  4. "owner": {
  5. "name": "pixel-noir",
  6. "url": "https://github.com/pixel-noir"
  7. },
  8. "plugins": [
  9. {
  10. "name": "lean-surf",
  11. "source": "./",
  12. "description": "Cuts the tokens an agent burns while browsing, without skipping the checks that matter.",
  13. "version": "1.0.0"
  14. }
  15. ]
  16. }
README.md · README · 131 lines
  1. <p align="center">
  2. <img src="assets/header.png" alt="lean-surf: browse more, burn less" width="100%">
  3. </p>
  4. <p align="center">
  5. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT license"></a>
  6. <img src="https://img.shields.io/badge/version-1.0.0-c8321e?style=flat-square" alt="version 1.0.0">
  7. <img src="https://img.shields.io/badge/Claude_Code-plugin-5b554b?style=flat-square" alt="Claude Code plugin">
  8. <img src="https://img.shields.io/badge/Agent_Skill-SKILL.md-2f6b3a?style=flat-square" alt="Agent Skill">
  9. <a href="https://paypal.me/BEMahdi"><img src="https://img.shields.io/badge/buy_me_a_coffee-PayPal-5b554b?style=flat-square&logo=paypal&logoColor=white" alt="Buy me a coffee"></a>
  10. </p>
  11. <p align="center">
  12. <b>English</b> · <a href="README.fr.md">Français</a>
  13. </p>
  14. ---
  15. You ask your agent to grab three prices from a shop. It takes a screenshot, dumps the whole accessibility tree, clicks, takes another screenshot to "confirm", dumps the page text, clicks "Next"…
  16. Every one of those results **stays in context and is re-sent on every later turn**. A screenshot at step 3 of a 30-step task is paid about 27 more times.
  17. **lean-surf** gets the same answer with a fraction of the tokens.
  18. ## What it changes
  19. | | Default agent | **lean-surf** |
  20. |---|---|---|
  21. | Public page, read-only | opens a browser | **API / WebFetch, no browser** |
  22. | Long browsing task | in the main context | **subagent, returns only the answer** |
  23. | Reading a page | full tree or full text | **`find` or 5 lines of JS** |
  24. | Screenshots | after every click | **only when visual, at `scale: 0.4`** |
  25. | Checking a click worked | screenshot | **URL or one-line JS check** |
  26. | Search, filters, paging | typing and clicking | **build the URL, raise page size** |
  27. | Irreversible step | — | **always verified properly** |
  28. ## Before / after
  29. *"Get the name and price of the first 10 products on this page."*
  30. <table>
  31. <tr><th>Before</th><th>After (<code>full</code>)</th></tr>
  32. <tr>
  33. <td>
  34. ```text
  35. screenshot() ~1,400 tok
  36. read_page() ~12,000 tok
  37. scroll + screenshot() ~1,400 tok
  38. get_page_text() ~9,800 tok
  39. ```
  40. **~24,600 tokens** in context, re-sent on every later turn.
  41. </td>
  42. <td>
  43. ```js
  44. [...document.querySelectorAll('.product')]
  45. .slice(0, 10).map(e => ({
  46. t: e.querySelector('h2')?.innerText.trim(),
  47. p: e.querySelector('.price')?.innerText.trim()
  48. }))
  49. ```
  50. **~300 tokens.** Same answer.
  51. </td>
  52. </tr>
  53. </table>
  54. <sub>Orders of magnitude, not benchmarks: they depend on the page and the viewport.</sub>
  55. <details>
  56. <summary><b>The one rule behind it</b></summary>
  57. <br>
  58. Before every browser call, the agent asks itself:
  59. > *Is there a cheaper call that returns only what I need?*
  60. If yes, it uses that one.
  61. </details>
  62. ## Install
  63. **Claude Code** (as a plugin):
  64. ```text
  65. /plugin marketplace add pixel-noir/lean-surf
  66. /plugin install lean-surf@lean-surf
  67. ```
  68. **Any agent that reads `SKILL.md`**:
  69. ```bash
  70. git clone https://github.com/pixel-noir/lean-surf.git
  71. cp -r lean-surf/skills/lean-surf ~/.claude/skills/
  72. ```
  73. ## Usage
  74. It kicks in on its own as soon as a task needs a web page or a browser tool. You can also say `lean-surf`, `browse cheap` or `save tokens browsing`. In French, `navigation économe` or `économise les tokens` work too.
  75. It stays on for the whole session. To turn it off, say `surf off` or `normal mode`.
  76. Works with **Claude in Chrome**, the **built-in browser**, **Playwright MCP** and **Chrome DevTools MCP**.
  77. | Level | What it does |
  78. |---|---|
  79. | `lite` | Right tool first, surgical reads, small screenshots. No forced delegation. |
  80. | `full` | **Default.** Everything, plus a subagent for any task over 3 actions, batching and URL-first. |
  81. | `ultra` | `full`, plus no screenshot unless the task is visual, delegation from 2 actions, step budget, capped extraction output. |
  82. Switch levels with `lean-surf lite`, `lean-surf full` or `lean-surf ultra`.
  83. > [!IMPORTANT]
  84. > **Some things are never cut, whatever the level:**
  85. > - a proper check of the page before any irreversible action (submit, send, pay, delete, publish)
  86. > - no guessed clicks: if the cheap read fails, the agent reads or looks properly
  87. > - a screenshot when you ask to see the page
  88. > - sign-in walls, CAPTCHAs, credentials and payments go to you
  89. > - a report of what wasn't checked or couldn't load
  90. ## Support
  91. If this project helped you, [buy me a coffee ☕️](https://paypal.me/BEMahdi).
  92. ## License
  93. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.