refresh-references

Track and update external reference repositories via JSON configuration.

Updated May 7, 2026
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill refresh-references
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-references
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/refresh-references
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill refresh-references

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually tracking and updating multiple external reference repositories used for project architecture, UI, and API pattern guidance is time-consuming and prone to human error, especially as the number of reference codebases grows.

Core Features & Use Cases

  • Configurable Repository Management: Define all reference repositories in a single JSON config file, with support for custom branches, URLs, and descriptions for each repo.
  • Automated Sync Workflows: Automatically clone missing reference repos and update existing ones using fast-forward only pulls to prevent unintended merge conflicts.
  • Explicit Status Reporting: Generate clear, actionable reports showing the sync status of each repo (up to date, updated, or missing) with no silent passes or assumed states.
  • Use Case: A development team maintaining multiple reference codebases for architecture and UI patterns can run a single command to sync all local clones to their latest upstream versions, eliminating hours of manual git operations per sprint.

Quick Start

Use the refresh-references skill to update all configured reference repositories to their latest upstream versions.

Frequently Asked Questions about refresh-references

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

FAQPage Schema
How do I keep multiple reference repositories synced to latest changes automatically?

To keep reference repositories synced automatically, you can use a JSON configuration file to define repo URLs, branches, and descriptions. The skill clones missing repositories and performs fast-forward only updates on existing ones, generating explicit status reports for all managed codebases.

What's the best way to update local clones of upstream reference codebases without merge conflicts?

Updating local clones without merge conflicts requires fast-forward only pulls. This approach prevents unintended merge conflicts by strictly advancing the local branch pointer to match the upstream reference repository state without creating divergent commit histories.

Can I use GitHub CLI to manage and sync external reference codebases for architecture patterns?

GitHub CLI is supported alongside native git operations for cloning and syncing external reference codebases. You can configure multiple upstream repositories with custom branches in a single JSON file, then execute one command to sync them all for pattern lookups.

Does syncing reference repositories with fast-forward only pulls work for teams with many codebases?

Fast-forward only repository syncing works effectively for teams maintaining numerous reference codebases. It scales by reading a single JSON configuration file to track all repositories, cloning missing ones, and updating existing clones while generating a clear status report for each managed repository.

Why does tracking reference repositories manually cause problems in development workflows?

Tracking reference repositories manually causes problems because it is time-consuming and prone to human error as the number of reference codebases grows. Automating the sync process eliminates hours of manual git operations per sprint and ensures architecture and UI pattern guidance is current.

What is a JSON configuration file for repository tracking and how does it work?

A JSON configuration file for repository tracking defines all reference codebases in a single location, supporting custom branches, URLs, and descriptions for each repo. It enables automated sync workflows to read the configuration, clone missing repositories, and generate explicit status reports.