sync-projects

Fetches GitHub repositories and NPM package data, then regenerates RSS feeds for a Next.js site.

1|Updated Feb 1, 2025
One-click install
npx skills add https://github.com/TiagoDanin/TiagoDanin.github.io --skill sync-projects-tiagodanin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-projects
Source: https://github.com/TiagoDanin/TiagoDanin.github.io/tree/main/.claude/skills/sync-projects
Command: npx skills add https://github.com/TiagoDanin/TiagoDanin.github.io --skill sync-projects-tiagodanin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a personal website's project listings, package stats, and RSS feeds up to date requires manually running multiple data-fetching commands and verifying the results, which is repetitive and error-prone. ## Core Features & Use Cases - GitHub Repository Sync: Fetches up to 300 repositories via the GitHub API, including stars, forks, language, and descriptions, saved to src/data/github.json. - NPM Package Sync: Retrieves published package data with download stats and version info, saved to src/data/npm.json. - RSS Feed Generation: Produces four RSS feeds covering blog posts, talks, timeline events, and projects. - Use Case: After publishing a new NPM package, run the sync to refresh your site's package listings and RSS feeds before rebuilding and deploying. ## Quick Start Ask the assistant to sync the project data from GitHub and NPM and regenerate the RSS feeds.

Frequently Asked Questions about sync-projects

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

FAQPage Schema
How do I sync GitHub repository data for my website?▼

Run yarn data:github to fetch up to 300 repositories from the GitHub API, including stars, forks, language, and descriptions. The results are saved to src/data/github.json for use during the site build.

How do I update NPM package stats on my site?▼

Run yarn data:npm to retrieve your published NPM packages with download stats and version information. The data is written to src/data/npm.json and included in the next build.

What happens if the GitHub API request fails during sync?▼

The sync retries once after 5 seconds if the GitHub API fails. If NPM fails, existing data is kept and a warning is shown. Existing data files are never overwritten by failed or partial updates.

Does the sync validate the fetched data?▼

Yes, after fetching it validates JSON syntax, checks the expected data structure, compares entry counts with the previous run, and warns if the data looks incomplete or significantly changed.

When should I run the project data sync?▼

Run it before major deployments, after publishing a new NPM package, or on a weekly schedule. After syncing, run yarn build to rebuild the site, or yarn deploy for the full pipeline.