Design with evidence, not vibes.

AI agents design from training data averages — generic layouts, safe colors, patterns you've seen a thousand times. This plugin gives your agent Lazyweb skills plus the hosted Lazyweb MCP server for real app and web screenshots.

Your agent searches before it designs. It finds real examples, downloads them locally, and produces structured reports with inline images you can preview in any markdown viewer.

/lazyweb-design-research — Deep design research. Identifies competitors, searches Lazyweb + web, downloads reference screenshots, and produces a structured report with: TL;DR, Examples, Findings, Patterns, Anti-Patterns, Unique Angles, and Recommendations. Use for competitive analysis and best practices research.

/lazyweb-quick-references — Find screenshots fast. Searches Lazyweb, downloads results, groups by pattern. Lighter than design-research — just find, group, show. Use when you need visual references, not a full report.

/lazyweb-design-improve — Improve an existing design. Captures a screenshot of your current app, finds similar screens from the best apps, and generates 1-5 concrete improvement ideas — each tied to a real reference. Adapted from Lazyweb's production design critique system.

/lazyweb-design-brainstorm — Cross-pollination brainstorm. Deliberately searches OUTSIDE your category to find novel patterns. If everyone in fintech copies each other, this skill looks at gaming, entertainment, and social apps for transferable ideas. The "zig when everyone zags" skill.

/lazyweb-add-inspo-source — Connect external inspiration libraries so Lazyweb design skills can include them in research.

/lazyweb-remove-inspo-source — Disconnect an external inspiration library.

This repo is packaged as a Codex plugin with:

• Plugin source in plugins/lazyweb/
• Skills in ~/plugins/lazyweb/skills/
• MCP config in ~/plugins/lazyweb/.mcp.json
• Marketplace entry in ~/.agents/plugins/marketplace.json

Set LAZYWEB_MCP_TOKEN or store the generated token at ~/.lazyweb/lazyweb_mcp_token. The plugin also checks the legacy ~/.codex/lazyweb_mcp_token path for existing installs. The plugin talks to https://www.lazyweb.com/mcp through mcp-remote.

This repo is also a Claude Code plugin marketplace. Add the marketplace, then install the plugin:

claude plugin marketplace add https://github.com/aboul3ata/lazyweb-skill
claude plugin install lazyweb@lazyweb

Claude Code skills are namespaced as /lazyweb:<skill-name>, for example /lazyweb:lazyweb-quick-references.

Run the no-login token endpoint:

mkdir -p ~/.lazyweb
curl -sS -X POST https://www.lazyweb.com/api/mcp/install-token \
  -H "content-type: application/json" \
  -d '{}' | node -e "let s='';process.stdin.on('data',d=>s+=d);process.stdin.on('end',()=>require('fs').writeFileSync(process.env.HOME+'/.lazyweb/lazyweb_mcp_token', JSON.parse(s).token))"

Lazyweb is free. This bearer token only authorizes Lazyweb MCP reference tools; it does not grant purchases, paid spend, private user data, or destructive actions. It is okay in ignored local config, but do not commit it to public git.

List MCP tools, run lazyweb_health, then run lazyweb_search with:

{"query":"pricing page","limit":3}

These public lazyweb_* tool names are compatibility aliases on https://www.lazyweb.com/mcp. They map to the current canonical MCP tools such as search_screenshots, list_filters, vision_screenshots, and metadata_screenshots.

Use MCP tools for all Lazyweb database access.

All skills produce a report with downloaded reference images:

.lazyweb/{skill}/{topic}-{date}/
├── report.md          <- Structured findings with inline images
└── references/        <- Downloaded screenshots (persisted locally)
    ├── stripe-pricing-page.png
    ├── linear-onboarding.png
    └── ...

Preview report.md in any markdown viewer to see the screenshots inline.

MIT