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.