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.