portfolio-auto

> **Note:** `last-sync.json` state file is auto-created on first successful sync. Ignore "missing file" warnings on first run. # Portfolio Auto-Sync Automatically sync GitHub repositories to your portfolio website. ## Workflow ### Step 1: Gather configuration Ask the user: - **GitHub username**: (default from git config) - **Portfolio type**: `static` (projects-data.js) or `supabase` (API) - **Portfolio directory**: Path to portfolio project - **Filters**: Exclude repos (archived, forks, specific names) ### Step 2: Fetch repos via GitHub API ``` GET /users/{username}/repos?per_page=100&sort=updated&direction=desc ``` Extract: `name`, `description`, `html_url`, `homepage`, `language`, `topics`, `updated_at` Filter out: - Forks (unless user opts in) - Profile repos (`{username}/{username}`) - Archived repos ### Step 3: Detect changes Compare against `last-sync.json` (stored in skill directory). - **New repos**: Not in last sync → full process - **Updated repos**: `updated_at` changed → re-screenshot - **Unchanged repos**: Skip ### Step 4: Capture screenshots For repos with a `homepage` or deploy URL: ```javascript const { chromium } = require('playwright'); const browser = await chromium.launch({ headless: true }); const page = await browser.newPage(); await page.setViewportSize({ width: 1280, height: 800 }); await page.goto(process.env.URL, { waitUntil: 'networkidle', timeout: 15000 }); await page.screenshot({ path: `/tmp/portfolio-${name}.png`, fullPage: false ...