sync-readmes

Name: sync-readmes
Availability: InStock
Author: mikkonumminen

Synchronize project metadata between portfolio registry and GitHub README files.

Updated Apr 6, 2026

Search Tags:#automation #github #readme #maintenance #sync #pull-request

Ready to run

npx skills add https://github.com/MikkoNumminen/mikkonumminen.dev --skill sync-readmes

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sync-readmes
Source: https://github.com/MikkoNumminen/mikkonumminen.dev/tree/main/.claude/skills/sync-readmes
Command: npx skills add https://github.com/MikkoNumminen/mikkonumminen.dev --skill sync-readmes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

This skill eliminates the manual overhead of keeping project metadata, such as tech stacks and descriptions, synchronized across a portfolio site and its individual source repositories.

Core Features & Use Cases

Parallel Auditing: Uses multiple AI agents to simultaneously compare project data against canonical README files in sibling repositories.
Automated Synthesis: Identifies factual drift, tech-list updates, and status changes, applying them consistently across project data and i18n files.
PR Automation: Automatically creates a Git worktree, runs CI checks, and opens a pull request for human review.

Quick Start

Invoke the sync-readmes skill to audit all sibling repositories and open a pull request with any necessary data corrections.

Frequently Asked Questions about sync-readmes

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

FAQPage Schema

How do I automate README synchronization across multiple GitHub repositories?▼

To automate README updates, this skill spawns parallel agents to detect factual drift in technical specifications against a central registry, then automatically creates a pull request for human review.

Do I need the GitHub CLI to automate pull request creation for README drift?▼

Yes, you need the GitHub CLI installed and authenticated, as the skill requires GitHub CLI integration to perform repository audits, worktree management, and automated pull request generation.

What is the best way to detect metadata drift between a portfolio site and source repositories?▼

Detecting metadata drift is best handled by parallel auditing agents that simultaneously compare project data, such as tech stacks and descriptions, against canonical README files in sibling repositories to identify factual inconsistencies.

How does automated synthesis apply tech stack updates to i18n files?▼

Automated synthesis identifies tech-list updates and status changes from sibling repositories, then consistently applies those factual corrections across project data and internationalization files to ensure metadata remains synchronized.

Can I run CI checks before opening a pull request for README updates?▼

Yes, the skill automatically creates a Git worktree and runs CI checks before opening a pull request, ensuring that automated README and metadata corrections do not break your existing build pipelines.