librarian

Cache and refresh remote git repositories for reusable local checkouts.

6|1|Updated Nov 23, 2023
One-click install
npx skills add https://github.com/gmcabrita/dotfiles --skill librarian-gmcabrita
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: librarian
Source: https://github.com/gmcabrita/dotfiles/tree/main/.agents/skills/librarian
Command: npx skills add https://github.com/gmcabrita/dotfiles --skill librarian-gmcabrita

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cache and refresh remote git repositories to enable reusable local checkouts.

Core Features & Use Cases

  • Stable local checkouts with deterministic paths.
  • Up-to-date caches through throttled fetches and optional fast-forward merges.
  • Efficient cloning with partial history (blob filtering) to minimize bandwidth.

Quick Start

Run checkout.sh <repo> --path-only to print the local cache path.

Frequently Asked Questions about librarian

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

FAQPage Schema
How do I cache and refresh remote git repositories for local reuse?

To cache and refresh remote git repositories, apply the Skill to GitHub, GitLab, or Bitbucket URLs to maintain a stable, updatable local checkout using deterministic paths and throttled fetches.

What is the best way to automate fast-forward updates for a local git cache?

Automating fast-forward updates for a local git cache involves using throttled fetches with optional force merges, ensuring your reusable local checkouts stay up-to-date without triggering unnecessary remote requests.

Can I use partial cloning with blob filtering to minimize git checkout bandwidth?

Yes, you can use partial cloning with blob filtering to minimize bandwidth, enabling efficient cloning of remote git repositories by fetching only the necessary history for your local cache.

Does this git repository caching approach work with owner/repo shorthand?

Yes, this git repository caching approach works with owner/repo shorthand, allowing you to easily generate and maintain stable local checkouts from GitHub, GitLab, or Bitbucket without requiring full URLs.

How do I get the deterministic local path for a cached git checkout?

To get the deterministic local path for a cached git checkout, run the checkout script with the repository argument and the path-only flag to print the exact local cache location for reuse.