# Git Readonly Sync

> Clone or pull public repositories in read-only workflows to gather reference material. Use when this capability is needed.

- Skill: `tomevault-io/git-readonly-sync` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/git-readonly-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/git-readonly-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/git-readonly-sync

---


Use this skill to retrieve repository content for analysis without pushing changes.

Guidelines:
1. Only use read-only Git operations (`clone`, `fetch`, `pull`, `show`, `log`).
2. Do not commit, push, rebase, or rewrite history.
3. Prefer shallow clones for speed when full history is unnecessary.
4. Keep repository paths explicit in outputs.

Inputs (CLI args):
- `--repo`: repository URL (https or ssh).
- `--dest`: destination directory.
- `--branch`: branch name (default: main).
- `--depth`: shallow clone depth (default: 1).
- `--token-env`: env var name containing a read-only token (optional).
- `--token-username`: username for the token (optional, defaults to x-access-token).

Notes:
- For private repos, provide `--token-env` and ensure the token is supplied via 1Password.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/simonvanlaak) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

