Skip to content

galiprandi/job-seeker / .agents/skills/browser-automation

browser-automation

Verified

Control a dedicated browser via agent-browser (Vercel). Use when automating web apps, scraping authenticated sites, filling forms, or navigating SPAs. Do NOT use for desktop apps or API-only integrations.

FileKindSize
SETUP.mdmarkdown3.0 KB
SKILL.mdskill md39.4 KB
references/agent-browser.mdmarkdown4.6 KB
references/api-capture.mdmarkdown1.8 KB
references/ats-patterns.mdmarkdown4.5 KB
references/audio-transcription.mdmarkdown2.4 KB
references/custom-combobox.mdmarkdown5.0 KB
references/efficiency-patterns.mdmarkdown2.6 KB
references/golden-rules.mdmarkdown5.7 KB
references/key-patterns.mdmarkdown4.4 KB
references/network-console.mdmarkdown1.2 KB
references/parallel-agents.mdmarkdown6.2 KB
references/profile-management.mdmarkdown6.3 KB
references/token-extraction.mdmarkdown2.8 KB
scripts/README.mdmarkdown6.0 KB
scripts/agent-browser.template.jsonconfig333 B
scripts/browser-share.jsscript20.0 KB
scripts/browser.jsexecutablescript17.1 KB
scripts/teams.jsscript7.1 KB
scripts/test-find-guide.jsscript6.3 KB
scripts/transcribe-audio.jsscript3.6 KB
scripts/viewer.htmlother8.6 KB
sites/CONTRIBUTING.mdmarkdown11.0 KB
sites/LEARN.mdmarkdown5.4 KB
sites/afip_gob_ar/guide.mdmarkdown9.0 KB
sites/app_web3forms_com/guide.mdmarkdown7.1 KB
sites/buk_co/guide.mdmarkdown1.5 KB
sites/calendar_google_com/calendar-deeplink.mdmarkdown1.9 KB
sites/calendly_com/guide.mdmarkdown1001 B
sites/careers_epam_com/guide.mdmarkdown4.4 KB
sites/dash_cloudflare_com/guide.mdmarkdown7.7 KB
sites/discord_com/guide.mdmarkdown9.9 KB
sites/discord_com/login-flow.mdmarkdown3.2 KB
sites/docs_google_com/guide.mdmarkdown7.3 KB
sites/facebook_com/guide.mdmarkdown9.8 KB
sites/gmail_com/guide.mdmarkdown35.6 KB
sites/google_com/guide.mdmarkdown1.1 KB
sites/google_com/login-flow.mdmarkdown3.3 KB
sites/google_home_com/guide.mdmarkdown2.1 KB
sites/google_maps_com/guide.mdmarkdown8.4 KB
sites/groq_com/signup-apikey.mdmarkdown6.6 KB
sites/humand_co/guide.mdmarkdown6.9 KB
sites/jira_com/guide.mdmarkdown10.8 KB
sites/linkedin_com/guide.mdmarkdown27.4 KB
sites/linkedin_com/outreach-strategy.mdmarkdown1.2 KB
sites/linkedin_com/posting.mdmarkdown14.0 KB
sites/linkedin_com/voyager-api.mdmarkdown8.1 KB
sites/mercadolibre_com/guide.mdmarkdown4.5 KB
sites/onstrider_com/draftjs-editor-fill.mdmarkdown2.3 KB
sites/onstrider_com/guide.mdmarkdown11.3 KB
sites/onstrider_com/react-autocomplete-inputs.mdmarkdown4.0 KB
sites/outlook_office_com/calendar-deeplink.mdmarkdown2.2 KB
sites/outlook_office_com/guide.mdmarkdown14.0 KB
sites/property_directory/guide.mdmarkdown3.7 KB
sites/reddit_com/guide.mdmarkdown16.2 KB
sites/teams_com/guide.mdmarkdown10.3 KB
sites/teamtailor_com/guide.mdmarkdown6.5 KB
sites/vea_com_ar/guide.mdmarkdown8.8 KB
sites/whatsapp_com/guide.mdmarkdown21.3 KB
sites/whatsapp_com/login-flow.mdmarkdown3.0 KB
sites/whatsapp_com/message-extraction.mdmarkdown5.7 KB
sites/whatsapp_com/voice-notes.mdmarkdown7.1 KB
sites/workatastartup_com/guide.mdmarkdown1.5 KB

scripts/test-find-guide.js

View on GitHub
#!/usr/bin/env node
/**
 * Test for findGuide — verifies that known hosts resolve to the correct
 * guide files and that unknown hosts return null.
 *
 * Mirrors the logic in browser.js:
 *   1. PATH_GUIDES override (hostname + path prefix)
 *   2. `domains:` frontmatter across sites/*//*.md — suffix match
 *   3. generic candidates [host, host-minus-first-label, first-label]
 *      sanitized to a directory name under sites/ + guide.md
 *
 * Run: node .agents/skills/browser-automation/scripts/test-find-guide.js
 */
'use strict';

const path = require('path');
const fs = require('fs');

const SITES_DIR = path.join(__dirname, '..', 'sites');

// Exact copy of PATH_GUIDES + parseFrontmatterDomains + buildDomainIndex +
// findGuide from browser.js — keep in sync.
const PATH_GUIDES = {
  'www.google.com/maps': 'google_com/maps-guide.md',
  'google.com/maps': 'google_com/maps-guide.md',
  'maps.google.com': 'google_com/maps-guide.md',
  'calendar.google.com': 'calendar_google_com/calendar-deeplink.md',
};

function parseFrontmatterDomains(filePath) {
  let head;
  try {
    const fd = fs.openSync(filePath, 'r');
    const buf = Buffer.alloc(8192);
    const n = fs.readSync(fd, buf, 0, 8192, 0);
    fs.closeSync(fd);
    head = buf.toString('utf8', 0, n);
  } catch {
    return [];
  }
  const fm = head.match(/^---\r?\n([\s\S]*?)\r?\n---/);
  if (!fm) return [];
  const body = fm[1];
  const dm = body.match(/^domains:[ \t]*(.*)$/m);
  if (!dm) return [];
  const inline = dm[1].trim();
  const out = [];
  const clean = (s) => s.trim().replace(/^['"]|['"]$/g, '').toLowerCase();
  if (inline.startsWith('[')) {
    for (const s of inline.replace(/^\[/, '').replace(/\].*$/, '').split(',')) {
      const v = clean(s);
      if (v) out.push(v);
    }
    return out;
  }
  for (const line of body.slice(body.indexOf(dm[0]) + dm[0].length).split(/\r?\n/)) {
    if (line.trim() === '') continue;
    const lm = line.match(/^\s*-\s*(\S+)\s*$/);
    if (!lm) break;
    out.push(clean(lm[1]));
  }
  return out;
}

function buildDomainIndex() {
  const idx = new Map();
  try {
    for (const dir of fs.readdirSync(SITES_DIR, { withFileTypes: true })) {
      if (!dir.isDirectory() || dir.name.startsWith('.')) continue;
      const dirPath = path.join(SITES_DIR, dir.name);
      for (const f of fs.readdirSync(dirPath)) {
        if (!f.endsWith('.md')) continue;
        const fp = path.join(dirPath, f);
        for (const d of parseFrontmatterDomains(fp)) {
          if (!idx.has(d)) idx.set(d, fp);
        }
      }
    }
  } catch { /* sites dir missing → empty index */ }
  return idx;
}

function findGuide(url) {
  try {
    const u = new URL(url);
    const hostname = u.hostname.toLowerCase().replace(/\.$/, '');
    if (!hostname) return null;
    const pathPrefix = u.pathname.split('/').filter(Boolean)[0] || '';

    const pathKey = pathPrefix ? `${hostname}/${pathPrefix}` : hostname;
    if (PATH_GUIDES[pathKey]) {
      const p = path.join(SITES_DIR, PATH_GUIDES[pathKey]);
      if (fs.existsSync(p)) return p;
    }
    if (PATH_GUIDES[hostname]) {
      const p = path.join(SITES_DIR, PATH_GUIDES[hostname]);
      if (fs.existsSync(p)) return p;
    }

    const parts = hostname.split('.');

    const idx = buildDomainIndex();
    for (let i = 0; i < parts.length - 1; i++) {
      const guidePath = idx.get(parts.slice(i).join('.'));
      if (guidePath) return guidePath;
    }

    const host = hostname.replace(/^www\./, '');
    const candidates = [host, host.split('.').slice(1).join('.'), host.split('.')[0]];
    for (const c of candidates) {
      if (!c) continue;
      const dir = path.join(SITES_DIR, c.replace(/[^a-z0-9_]/g, '_'));
      const guide = path.join(dir, 'guide.md');
      if (fs.existsSync(guide)) return guide;
    }
  } catch {}
  return null;
}

// Test cases: [url, expectedPath or null]
const tests = [
  // Full host match (generic candidate or declared domain)
  ['https://outlook.office.com/', 'outlook_office_com/guide.md'],
  ['https://dash.cloudflare.com/', 'dash_cloudflare_com/guide.md'],
  ['https://app.web3forms.com/', 'app_web3forms_com/guide.md'],
  ['https://docs.google.com/', 'docs_google_com/guide.md'],
  ['https://www.vea.com.ar/', 'vea_com_ar/guide.md'],
  ['https://afip.gob.ar/', 'afip_gob_ar/guide.md'],
  // www. stripped, then full host match
  ['https://www.linkedin.com/', 'linkedin_com/guide.md'],
  ['https://www.reddit.com/', 'reddit_com/guide.md'],
  ['https://www.jira.com/', 'jira_com/guide.md'],
  ['https://www.facebook.com/', 'facebook_com/guide.md'],
  ['https://www.discord.com/', 'discord_com/guide.md'],
  ['https://discord.com/', 'discord_com/guide.md'],
  ['https://humand.co/', 'humand_co/guide.md'],
  // domains: frontmatter resolution
  ['https://web.whatsapp.com/', 'whatsapp_com/guide.md'],
  ['https://mail.google.com/', 'gmail_com/guide.md'],
  ['https://mail.google.com/mail/u/0/#inbox', 'gmail_com/guide.md'],
  ['https://inbox.google.com/', 'gmail_com/guide.md'],
  ['https://calendar.google.com/', 'calendar_google_com/calendar-deeplink.md'],
  ['https://teams.microsoft.com/', 'teams_com/guide.md'],
  ['https://teams.live.com/', 'teams_com/guide.md'],
  ['https://foo.linkedin.com/', 'linkedin_com/guide.md'],
  ['https://foo.bar.linkedin.com/', 'linkedin_com/guide.md'], // suffix match
  // Path-based overrides
  ['https://www.google.com/maps', 'google_com/maps-guide.md'],
  ['https://maps.google.com/', 'google_com/maps-guide.md'],
  ['https://xx.linkedin.com/', 'linkedin_com/guide.md'],
  // Subdomain of a declared domain → resolves via suffix match
  // (groq_com declares groq.com on a non-guide.md file)
  ['https://api.groq.com/', 'groq_com/signup-apikey.md'],
  // No guide: candidates sanitize to dirs that don't exist
  ['https://example.com/', null],
  ['https://localhost:3000/', null],
  // Invalid URL
  ['not-a-url', null],
];

let passed = 0;
let failed = 0;

for (const [url, expected] of tests) {
  const result = findGuide(url);
  const resultSlug = result ? path.relative(SITES_DIR, result).replace(/\\/g, '/') : null;
  const ok = resultSlug === expected;
  if (ok) {
    passed++;
  } else {
    failed++;
    console.log(`FAIL: ${url}`);
    console.log(`  expected: ${expected}`);
    console.log(`  got:      ${resultSlug}`);
  }
}

console.log(`\n${passed} passed, ${failed} failed, ${tests.length} total`);
process.exit(failed > 0 ? 1 : 0);
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall