How do I install the Gh Repo Cartographer skill?

Run npx skillmds@latest add harzva/gh-repo-cartographer-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gh Repo Cartographer safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gh Repo Cartographer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gh Repo Cartographer free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gh Repo Cartographer?

harzva (@harzva) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gh Repo Cartographer by harzva — Agent Skill

Name: Gh Repo Cartographer
Author: harzva

Gh Repo Cartographer

Inventory locally configured GitHub accounts and repositories, map online GitHub repositories to local Git project folders, verify whether local branches match fetched upstream commits, batch-fetch GitHub Pages and release metadata, and produce Markdown/JSON reports for README optimization, repository cleanup, publishing audits, Pages matrices, release hubs, or account migration work. Use when the user asks to list all GitHub repos, find local project locations for GitHub repos, check local-vs-remote version status, audit README targets, collect Pages URLs/releases, or organize repos across Harzva/saihao/Just-Agent style managed accounts.

harzva Updated Sep 22, 2026

File contents

GH Repo Cartographer

Quick Start

Use the bundled script for deterministic inventory work. From this skill or repository directory:

python scripts\gh_repo_cartographer.py --include-pages --include-releases --output github-repo-map.md --json-output github-repo-map.json

The script:

Reads managed account aliases from gh-account-router when available.
Resolves each alias to its canonical GitHub login with gh api user.
Lists repositories owned by each resolved login, with a REST API fallback when gh repo list GraphQL calls time out.
Resolves router URL aliases such as https://github.com/just-agent, saihao to the canonical GitHub login.
Optionally fetches GitHub Pages status/URL and latest release metadata for every repository.
Scans local Git repositories under configured roots.
Matches local remotes to github.com/owner/repo.
Fetches remotes by default, then compares HEAD with @{u} to report synced, behind, ahead, diverged, no-upstream, or no-local-copy.

Common Options

Add scan roots with repeated --scan-root <path>. If omitted, the script uses GH_REPO_CARTOGRAPHER_ROOTS when set, otherwise the current directory.
Add account aliases with repeated --account <alias>. If omitted, aliases are discovered from gh-account-router.
Set GH_ACCOUNT_ROUTER when gh-account-router is installed somewhere other than ~/.codex/skills/gh-account-router/scripts/gh_account_router.py.
Use --no-fetch only when the user explicitly wants a faster offline check; mark results as based on stale local remote refs.
Use --include-pages when building a Pages matrix or homepage preview index.
Use --include-releases when building a release hub or project matrix with release badges.
Use --max-depth <n> to widen or narrow local scanning.
Use --output <file> for a Markdown report and --json-output <file> for downstream README automation.

Reporting Guidance

Summarize the Markdown report in the final answer:

Number of remote repositories found.
Number of repositories with GitHub Pages.
Number of repositories with releases.
Number matched to local folders.
Repositories that are behind, ahead, diverged, dirty, or missing local copies.
Local repositories with GitHub remotes outside the managed accounts.
The report paths created.

Never print raw tokens or access-file contents. If authentication fails, report the account alias/login and the GitHub error after token redaction.

README Optimization Workflow

After generating the map, use it to prioritize README work:

Start with repositories that have local matches and are synced.
For behind or diverged repos, ask before editing README content unless the user clearly asked to update local branches.
For no-local-copy repos, recommend cloning before README optimization.
Use the JSON report when batching README audits or generating dashboards.

---name: gh-repo-cartographer-2description: Inventory locally configured GitHub accounts and repositories, map online GitHub repositories to local Git project folders, verify whether local branches match fetched upstream commits, batch-fetch GitHub Pages and release metadata, and produce Markdown/JSON reports for README optimization, repository cleanup, publishing audits, Pages matrices, release hubs, or account migration work. Use when the user asks to list all GitHub repos, find local project locations for GitHub repos, check local-vs-remote version status, audit README targets, collect Pages URLs/releases, or organize repos across Harzva/saihao/Just-Agent style managed accounts.---# GH Repo Cartographer## Quick StartUse the bundled script for deterministic inventory work. From this skill or repository directory:```powershellpython scripts\gh_repo_cartographer.py --include-pages --include-releases --output github-repo-map.md --json-output github-repo-map.json```The script:- Reads managed account aliases from `gh-account-router` when available.- Resolves each alias to its canonical GitHub login with `gh api user`.- Lists repositories owned by each resolved login, with a REST API fallback when `gh repo list` GraphQL calls time out.- Resolves router URL aliases such as `https://github.com/just-agent, saihao` to the canonical GitHub login.- Optionally fetches GitHub Pages status/URL and latest release metadata for every repository.- Scans local Git repositories under configured roots.- Matches local remotes to `github.com/owner/repo`.- Fetches remotes by default, then compares `HEAD` with `@{u}` to report `synced`, `behind`, `ahead`, `diverged`, `no-upstream`, or `no-local-copy`.## Common Options- Add scan roots with repeated `--scan-root <path>`. If omitted, the script uses `GH_REPO_CARTOGRAPHER_ROOTS` when set, otherwise the current directory.- Add account aliases with repeated `--account <alias>`. If omitted, aliases are discovered from `gh-account-router`.- Set `GH_ACCOUNT_ROUTER` when `gh-account-router` is installed somewhere other than `~/.codex/skills/gh-account-router/scripts/gh_account_router.py`.- Use `--no-fetch` only when the user explicitly wants a faster offline check; mark results as based on stale local remote refs.- Use `--include-pages` when building a Pages matrix or homepage preview index.- Use `--include-releases` when building a release hub or project matrix with release badges.- Use `--max-depth <n>` to widen or narrow local scanning.- Use `--output <file>` for a Markdown report and `--json-output <file>` for downstream README automation.## Reporting GuidanceSummarize the Markdown report in the final answer:- Number of remote repositories found.- Number of repositories with GitHub Pages.- Number of repositories with releases.- Number matched to local folders.- Repositories that are `behind`, `ahead`, `diverged`, dirty, or missing local copies.- Local repositories with GitHub remotes outside the managed accounts.- The report paths created.Never print raw tokens or access-file contents. If authentication fails, report the account alias/login and the GitHub error after token redaction.## README Optimization WorkflowAfter generating the map, use it to prioritize README work:1. Start with repositories that have local matches and are `synced`.2. For `behind` or `diverged` repos, ask before editing README content unless the user clearly asked to update local branches.3. For `no-local-copy` repos, recommend cloning before README optimization.4. Use the JSON report when batching README audits or generating dashboards.

Frequently asked questions