skills.rest
MikkoNumminen
MikkoNumminenCOMMUNITY
Explore all skills by this author →
GitHub

sync-readmes

Synchronize project metadata between portfolio registry and GitHub README files.

Updated Apr 6, 2026
Search Tags:#automation#github#readme#maintenance#sync#pull-request
One-click install
npx skills add https://github.com/MikkoNumminen/mikkonumminen.dev --skill sync-readmes
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
granietgraniet
247

github-auth

Automates GitHub authentication setup for git, SSH, gh CLI, and API access.

Community
Intermediate
AnveioAnveio
1

task-pull-request

Automate GitHub pull request creation, reviews, feedback, and merges via gh CLI.

Community
Intermediate
mikecubedmikecubed

worktree

Provision and manage git worktrees for parallel development tracks.

Community
Advanced
tygwantygwan
1

readme-sync

Scan the .claude directory and update README sections to match project components.

Community
Basic