lazyweb-add-inspo-source

name	lazyweb-add-inspo-source
description	Connect an external inspiration source (Mobbin, Savee, Dribbble, Behance, etc.) as a first-class source in all Lazyweb design skills. Authenticates via headless browser, persists session cookies, and registers the source so future design research automatically includes it alongside Lazyweb. Trigger on: "add inspo source", "add inspiration source", "connect Mobbin", "connect Savee", "add design source", "connect inspiration", "add Dribbble", "link Behance".
allowed-tools	["Bash","Read","Write","AskUserQuestion"]

Add Inspiration Library

Connect an external design inspiration library so all Lazyweb design skills (/lazyweb-design-research, /lazyweb-design-improve, /lazyweb-design-brainstorm, /lazyweb-quick-references) search it alongside Lazyweb's database.

No adapters or scrapers needed — Claude uses the browse tool to navigate the library UI at search time, the same way it browses any website.

Browse Setup

LB=""
# Check lazyweb-skill browse first
for _P in "$(pwd)/.claude/skills/lazyweb-skill/browse/dist/browse" ~/.claude/skills/lazyweb-skill/browse/dist/browse; do
  [ -x "$_P" ] && LB="$_P" && break
done
# Fall back to gstack browse
if [ -z "$LB" ]; then
  _ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
  [ -n "$_ROOT" ] && [ -x "$_ROOT/.claude/skills/gstack/browse/dist/browse" ] && LB="$_ROOT/.claude/skills/gstack/browse/dist/browse"
  [ -z "$LB" ] && [ -x ~/.claude/skills/gstack/browse/dist/browse ] && LB=~/.claude/skills/gstack/browse/dist/browse
fi
[ -x "$LB" ] && echo "BROWSE_READY: $LB" || echo "NO_BROWSE"

If NO_BROWSE: This skill requires the browse tool. Tell the user: "Browse tool not found. Install it with: cd ~/.claude/skills/lazyweb-skill/browse && ./setup" Then stop.

Workflow

1. Ask Which Library

If the user didn't specify, ask which library to connect. Common options:

Library	URL	Search URL
Mobbin	https://mobbin.com	https://mobbin.com/browse/ios/apps
Savee	https://savee.it	https://savee.it/search/
Dribbble	https://dribbble.com	https://dribbble.com/search
Behance	https://www.behance.net	https://www.behance.net/search/projects
Awwwards	https://www.awwwards.com	https://www.awwwards.com/websites

If the user wants a library not listed here, ask for:

• Name of the library
• Base URL
• Search URL (the page where you can type a search query)

2. Check If Already Connected

cat ~/.lazyweb/libraries.json 2>/dev/null || echo '{"libraries":[]}'

If the library is already in the list, tell the user it's already connected and ask if they want to re-authenticate (useful if session expired).

3. Authenticate via Headless Browser

Navigate to the library and hand off to the user for login:

# Open the library's login page
$LB goto "{url}"

# Hand off to visible Chrome so user can log in
$LB handoff "Log in to {name}. Close this window or press Enter when done."

The handoff opens a visible Chrome window where the user can:

• Log in with email/password
• Complete OAuth flows
• Handle 2FA/CAPTCHA

After the user completes login:

# Resume headless control with cookies preserved
$LB resume

4. Verify Authentication

Navigate to the search page and confirm we're logged in:

$LB goto "{searchUrl}"
$LB snapshot -i

Check the snapshot for signs of being logged in (user avatar, account menu, no login prompts). If it looks like we're not authenticated, tell the user and offer to retry.

5. Test Search

Do a quick test search to confirm everything works:

$LB snapshot -i
# Find the search input and type a test query
$LB fill @eN "pricing page"
$LB press Enter
# Wait briefly for results
$LB snapshot -i

If results load successfully, the connection works.

6. Save Library Config

mkdir -p ~/.lazyweb

Read existing config, add the new library, write back:

{
  "libraries": [
    {
      "name": "Mobbin",
      "url": "https://mobbin.com",
      "searchUrl": "https://mobbin.com/browse/ios/apps",
      "addedAt": "2026-03-26"
    }
  ]
}

Write to ~/.lazyweb/libraries.json.

7. Confirm to User

Tell the user:

• "{Name} is now connected as an inspiration source."
• "All Lazyweb design skills will now search {Name} alongside Lazyweb's database."
• "If your session expires, run /lazyweb-add-inspo-source again to reconnect."
• "To disconnect, run /lazyweb-remove-inspo-source."

Important Notes

• Session persistence: Browse cookies persist within a server session (30 min idle timeout). If the session expires between uses, the design skills will detect this and prompt the user to reconnect.
• No adapters: Claude navigates each library's UI at search time using browse snapshots and interactions. This means it works with any library, even ones that redesign their UI.
• Multiple libraries: Users can connect as many libraries as they want. Each gets searched during design research.