portfolio-auto

Sync GitHub repositories into a static or Supabase portfolio with metadata and screenshots.

110|14|Updated May 12, 2026
One-click install
npx skills add https://github.com/EliasOulkadi/shokunin --skill portfolio-auto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: portfolio-auto
Source: https://github.com/EliasOulkadi/shokunin/tree/main/.pack/skills/portfolio-auto
Command: npx skills add https://github.com/EliasOulkadi/shokunin --skill portfolio-auto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the repetitive, error-prone work of manually updating a portfolio when your GitHub repositories change, including adding new projects and refreshing screenshots and metadata.

Core Features & Use Cases

  • GitHub repo discovery & filtering: Pulls repositories for a given GitHub username and filters out forks/archived/profile repos based on configured rules.
  • Change detection with sync state: Uses a persistent last-sync.json to detect new and updated repositories so only changed projects get reprocessed.
  • Screenshot capture for live previews: Uses Playwright to capture homepage/deploy screenshots (skipping repos without a valid live URL).
  • Portfolio data updates: Writes project entries into either a static projects-data.js file or a Supabase backend.

Quick Start

Ask the skill to refresh your portfolio by syncing all repos for your GitHub username, targeting either the static projects-data.js or your Supabase project API.

Frequently Asked Questions about portfolio-auto

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically sync GitHub repositories to my portfolio website?▼

To sync GitHub repositories to your portfolio automatically, you can use a tool that fetches repos via the GitHub REST API, detects changes using persistent sync state, and upserts project entries into your portfolio target.

Can I capture website screenshots for my portfolio projects using Playwright?▼

Yes, you can capture website screenshots for portfolio projects using Playwright, which automates taking homepage or deploy previews from live URLs while skipping repositories without a valid live link.

How do I update a static portfolio site with new GitHub project metadata?▼

Updating a static portfolio site with GitHub project metadata involves writing refreshed repository details directly into a static projects-data.js file while preserving any existing user customizations.

Does this portfolio sync tool work with a Supabase backend?▼

Yes, this portfolio sync tool works with a Supabase backend, allowing you to upsert project entries directly into your Supabase project API instead of a static file.

How does change detection work when syncing GitHub repos to a portfolio?▼

Change detection when syncing GitHub repos uses a persistent last-sync.json file to identify new and updated repositories, ensuring only changed projects get reprocessed during the sync.

Can I filter out forked or archived GitHub repositories when syncing to a portfolio?▼

Yes, you can filter out forked, archived, and profile repositories when syncing to a portfolio by applying configured rules during the GitHub repository discovery process.