First-time GitHub setup and interactive git learning. An agent skill from jeremylongshore/tons-of-skills-marketplace.

MITAuto-check: notesEducation

Install Navigating GitHub

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill navigating-github -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace navigating-github --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/navigating-github .claude/skills/navigating-github && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
navigating-github
GitHub stars
2.8k
Token cost
~2.3k tokens
SKILL.md length
928 words
Files
8 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

First-time GitHub setup and interactive git learning. An agent skill from jeremylongshore/tons-of-skills-marketplace.

  • Works in 2 steps: Route → Infer Skill Level
  • The user asks to set up GitHub
  • SKILL.md covers Table of Contents, Overview, Prerequisites and Instructions, plus 5 more sections
  • Calls gh, git and brew

What it does

Navigating GitHub is an agent skill from jeremylongshore/tons-of-skills-marketplace. First-time GitHub setup and interactive git learning. Walks users from zero to a working GitHub repo, then teaches git through 9 hands-on lessons on their actual project. Adapts language and depth to skill level — inferred from environment, not questionnaires. Two modes: Setup (guided onboarding) and Learn (progressive curriculum from commits to CI/CD). Use when the user asks to set up GitHub, learn git, or says "teach me github". Trigger with "set up my repo", "help me with github", "teach me github", "learn…

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/claude-github-platforms.md`, `references/error-recovery-playbook.md` and `references/git-concepts-glossary.md`). Compatibility notes: Designed for Claude Code and Continue

It sits in Education, covering Tutoring and explanations, Git workflow and CI/CD. It works with GitHub and Git. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • The user asks to set up GitHub
  • Says teach me github
  • With set up my repo
  • Help me with github

Example prompts

  • “teach me github”
  • “set up my repo”
  • “help me with github”
  • “/navigating-github”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code and Continue
  • Pre-approved tools (allowed-tools): Read, Write, Glob, Grep, Bash(git:*), Bash(gh:*), Bash(ssh:*), Bash(test:*), Bash(echo:*), AskUserQuestion

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Route
  2. Infer Skill Level

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Glob
    • Grep
    • Bash(git:*)
    • Bash(gh:*)
    • Bash(ssh:*)
    • Bash(test:*)
    • Bash(echo:*)
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git
    • brew
    • apt
    • winget

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code and Continue

    From compatibility in the SKILL.md frontmatter.

Context cost

Navigating GitHub loads about 2.3k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 150 tokens; SKILL.md has 928 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~150
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:122
    - Never commit secrets — check for `.env`, API keys before staging

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 928 words, ~2,306 tokens.

Download SKILL.mdSave it as .claude/skills/navigating-github/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
navigating-github
description
First-time GitHub setup and interactive git learning. Walks users from zero to a working GitHub repo, then teaches git through 9 hands-on lessons on their actual project. Adapts language and depth to skill level — inferred from environment, not questionnaires. Two modes: Setup (guided onboarding) and Learn (progressive curriculum from commits to CI/CD). Use when the user asks to set up GitHub, learn git, or says "teach me github". Trigger with "set up my repo", "help me with github", "teach me github", "learn git", "what are branches", "teach me PRs", or "how do I use github".
allowed-tools
Read, Write, Glob, Grep, Bash(git:*), Bash(gh:*), Bash(ssh:*), Bash(test:*), Bash(echo:*), AskUserQuestion
compatibility
Designed for Claude Code and Continue
version
2.5.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
tags
github, git, beginner, intermediate, advanced, vibe-coding, version-control, learning, onboarding

Navigating GitHub

First-time GitHub setup and interactive git learning. Get set up, then learn by doing.

Table of Contents

  1. Overview — 2. Prerequisites — 3. Instructions — 4. Modes — 5. Examples — 6. Output — 7. Resources

Overview

Problem: Getting started with GitHub is the #1 barrier for people building with AI. Beginners stall at setup, don't understand commits vs pushes vs PRs, and have nobody to walk them through it hands-on. AI coding tools can run git commands, but they don't teach you what those commands mean or guide you through setup from scratch.

Solution: Walk users through GitHub setup step by step, then teach git and GitHub through 9 progressive hands-on lessons on their actual project. Every lesson uses do-then-explain: run the command, see the result, then understand why. Adapts language and depth to skill level automatically.

Prerequisites

  • Terminal access with git installed
  • gh CLI installed (Setup handles installation if missing)
  • GitHub account (Setup handles creation if missing)

Instructions

Step 1 — Route

Determine mode from the user's request. Act immediately — no preamble.

  1. No .git/ directory OR gh auth status fails → Setup (check with test -d .git and gh auth status)
  2. Keywords "teach", "learn", "what are", "how do", "explain", "lesson" → Learn
  3. Keywords "set up", "new repo", "init", "get started" → Setup
  4. Generic ("help me with github") → check environment, route to Setup if no repo, otherwise offer lesson menu
Step 2 — Infer Skill Level

Each mode runs git status as part of its normal operation. Infer level from those signals — no extra commands:

  • Only main branch + short/vague commit messages → Beginner
  • A few branches + descriptive commits → Intermediate
  • Branch naming conventions + conventional commits → Advanced
  • Complex history, multiple remotes, CI configured → Expert

Only ask via AskUserQuestion when signals are genuinely ambiguous. Read ${CLAUDE_SKILL_DIR}/references/skill-assessment-guide.md for the full adaptive behavior matrix. Apply:

LevelLanguageDepthAutonomy
BeginnerAnalogies, zero jargonExplain everythingExecute and teach along the way
IntermediateLight jargon, define termsExplain the whyExecute, ask to confirm
AdvancedStandard vocabularyBrief rationale onlySuggest, let user decide
ExpertTerse, technicalNone unless askedAssist only

Modes

Setup — Guided Onboarding

The core experience for first-time users. Walk through each step interactively, skipping anything already done. Run each check, explain what it means, fix what's missing.

Sequence: Check gh auth status → install gh if missing (detect OS, give command) → run gh auth login (walk through browser OAuth) → check git config user.name and user.email (set if missing) → check for .git/ (run git init if missing) → generate .gitignore by detected project type → create first commit → run gh repo create (let user choose public/private) → push → show the repo URL.

Skip completed steps. Explain each step at the inferred level. After completion, offer the lesson menu: "Repo is set up. Say 'teach me github' or run /github-learn to start learning."

Show full SKILL.md (467 more words)Show less
Learn — Interactive Curriculum

Hands-on lessons using real commands on the user's actual project. Every lesson follows do-then-explain: run a real command, observe the result, THEN explain what happened. Verify understanding after each step before proceeding.

Read ${CLAUDE_SKILL_DIR}/references/learning-curriculum.md for the full curriculum. Route by trigger:

Beginner track:

  • "teach me github" / "learn github" → GitHub 101 — commits, push, the basics
  • "what are branches" / "teach me branches" → Branching Basics — create, switch, see the difference
  • "teach me PRs" → Your First PR — branch, push, create PR, merge

Intermediate track:

  • "teach me branching strategies" → Branch Workflows — naming, feature branches, staying current
  • "teach me code review" → PR Review Flow — review, comment, approve
  • "how do I collaborate" → Team Git — forks, upstream sync, co-authoring

Advanced track:

  • "teach me rebase" → Rebase vs Merge — interactive rebase, squash, clean history
  • "teach me CI/CD" / "github actions" → GitHub Actions — write a workflow, watch it run
  • "how do code review apps work" → Review Ecosystem — CodeRabbit, Copilot Review, and the ecosystem (read ${CLAUDE_SKILL_DIR}/references/github-review-apps.md)

After each lesson: summarize what was learned (2-3 bullets), give a small challenge to try solo, suggest the next lesson.

Teaching rules:

  • Run commands one at a time, explain after each result
  • If the user makes a mistake, fix it together — mistakes are learning moments
  • If the user already knows something, skip ahead
  • If the user seems confused, slow down and simplify
  • Create a safe practice branch before exercises that modify the repo
  • Never push to main/master during lessons — always branch first
  • Never commit secrets — check for .env, API keys before staging

Examples

Setup (no .git, no auth):

User: "help me with github"
Agent: [checks — no .git, gh not authenticated]
Agent: "Starting from scratch. First, connect to GitHub..."
Agent: [walks through gh auth login, git config, git init, gh repo create]
Agent: "Repo is live at github.com/user/project. Run /github-learn to
       start learning commits and branches."

Learn (beginner, GitHub 101):

User: "teach me github"
Agent: "Make a small change to any file — add a comment, fix a typo."
User: [edits a file]
Agent: "Now save that change: git add README.md"
Agent: "That moved the change to the staging area — like putting a letter
       in an envelope. Now seal it: git commit -m 'Update README'"
Agent: [verifies understanding before moving to next step]

Learn (advanced, rebase):

User: "/github-learn rebase"
Agent: "Create a branch with 3 small commits, then we'll squash them."
Agent: [guides through git rebase -i, explains pick/squash/fixup]

Output

Calibrate all output to the inferred skill level. Beginner: plain English with analogies, explain every command. Intermediate: concise summaries, explain rationale. Advanced: minimal commentary. Expert: raw output only. Read ${CLAUDE_SKILL_DIR}/references/git-concepts-glossary.md when a term definition is needed.

Error Handling

  • gh not installed: Detect missing CLI, provide platform-specific install instructions (brew install gh, apt install gh, winget install GitHub.cli), then resume setup.
  • Authentication failure: If gh auth status fails, walk through gh auth login with browser OAuth flow. If token is expired, run gh auth refresh.
  • No git remote: If git remote -v returns empty, guide through gh repo create or git remote add origin <url>.
  • Merge conflict during lesson: Explain what a conflict is at the user's level, show the conflict markers, and walk through resolution step by step.
  • Detached HEAD: Detect with git status, explain in plain language, and recover with git checkout <branch>.

Resources

  • ${CLAUDE_SKILL_DIR}/references/learning-curriculum.md — 9 progressive lesson plans from beginner through advanced
  • ${CLAUDE_SKILL_DIR}/references/git-concepts-glossary.md — term definitions at beginner and technical levels
  • ${CLAUDE_SKILL_DIR}/references/skill-assessment-guide.md — adaptive behavior matrix with level-up and level-down signals
  • ${CLAUDE_SKILL_DIR}/references/safety-rules.md — branch protection, secret detection, destructive operation guards
  • ${CLAUDE_SKILL_DIR}/references/error-recovery-playbook.md — conflict resolution, auth repair, detached HEAD, rebase recovery
  • ${CLAUDE_SKILL_DIR}/references/github-review-apps.md — CodeRabbit, Copilot Review, Greptile, CodeQL, Qodo
  • ${CLAUDE_SKILL_DIR}/references/claude-github-platforms.md — platform capabilities across Claude Code, Cursor, Windsurf, and others

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in skills/.curated/navigating-github of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/claude-github-platforms.md
  • references/error-recovery-playbook.md
  • references/git-concepts-glossary.md
  • references/github-review-apps.md
  • references/learning-curriculum.md
  • references/safety-rules.md
  • references/skill-assessment-guide.md

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Navigating GitHub next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Navigating GitHub compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Navigating GitHub this skilljeremylongshore/tons-of-skills-marketplace2.8k—~2.3kAutomated safety check: NotesMIT
Worktrunk Release Workflowmax-sixty/worktrunk9.1k—~6.9kAutomated safety check: PassCustom licence
npm Package Publisherklaudworks/universal-skills181—~923Automated safety check: PassMIT
ccLoad Release Publishercaidaoli/ccLoad419—~887Automated safety check: PassMIT
Push and PyPI Releaseliaohch3/claude-tap3.3k—~509Automated safety check: PassMIT
Codex Proxy RS Releasezyycn/codex-proxy-rs766—~327Automated safety check: PassApache-2.0

Similar skills

  • Worktrunk Release Workflow

    max-sixty/worktrunk

    Walks a maintainer through cutting a Worktrunk release: sync the release branch, pass two test gates, review the changes, then publish.

    9.1k GitHub stars~6.9k tokensUpdated today
    DevelopmentAuto-check passed
  • npm Package Publisher

    klaudworks/universal-skills

    Releases an npm package by committing changes, bumping the version with npm version, pushing the tag and checking the GitHub Actions publish.

    181 GitHub stars~923 tokensUpdated 8 mo ago
    DevelopmentAuto-check passed
  • Publishes a ccLoad Beta or explicit stable release through a version-tag workflow, including commit, push, CI wait, GitHub Release and container image checks.

    419 GitHub stars~887 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Push and PyPI Release

    liaohch3/claude-tap

    Pushes the current work to GitHub and, when pending commits change code, bumps the version in pyproject.toml so CI publishes a new PyPI release.

    3.3k GitHub stars~509 tokensUpdated 16 days ago
    DevelopmentAuto-check passed
  • Codex Proxy RS Release

    zyycn/codex-proxy-rs

    Plans versions, writes release notes, publishes stable or pre-release builds and recovers from failed releases for Codex Proxy RS, without covering deploys or tag cleanup.

    766 GitHub stars~327 tokensUpdated today
    DevelopmentAuto-check passed
  • PR Create

    posit-dev/skills

    Creates a pull request from current changes, monitors GitHub CI, and debugs any failures until CI passes.

    533 GitHub stars~4.3k tokensUpdated yesterday
    DevelopmentAuto-check: warnings

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Questions about Navigating GitHub

What does Navigating GitHub do?

First-time GitHub setup and interactive git learning. An agent skill from jeremylongshore/tons-of-skills-marketplace. Navigating GitHub is an agent skill from jeremylongshore/tons-of-skills-marketplace. First-time GitHub setup and interactive git learning.

When should I use Navigating GitHub?

Navigating GitHub fits situations like: the user asks to set up GitHub; says teach me github; with set up my repo; help me with github.

How do I install Navigating GitHub in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill navigating-github -a claude-code`. Or copy the skill folder (skills/.curated/navigating-github in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/navigating-github in your project. Claude Code loads it when a task matches its description.

How do I install Navigating GitHub in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill navigating-github -a codex`. Or copy the skill folder (skills/.curated/navigating-github in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/navigating-github in your project. Codex loads it when a task matches its description.

Can I use Navigating GitHub in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill navigating-github -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/navigating-github, .gemini/skills/navigating-github, .github/skills/navigating-github and .opencode/skills/navigating-github in your project.

What does Navigating GitHub need to run?

Going by SKILL.md and its folder, Navigating GitHub needs the command-line tools its instructions call (gh, git, brew, apt and winget). Its frontmatter pre-approves these tools: Read, Write, Glob, Grep, Bash(git:*), Bash(gh:*), Bash(ssh:*), Bash(test:*), Bash(echo:*), AskUserQuestion. Compatibility (from SKILL.md): Designed for Claude Code and Continue.

Does Navigating GitHub access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Navigating GitHub safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Navigating GitHub use?

Navigating GitHub is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Navigating GitHub use?

About 2.3k tokens (SKILL.md is roughly 9.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to Navigating GitHub?

Skills that share tags, products or a category with Navigating GitHub: Worktrunk Release Workflow (max-sixty/worktrunk, 9.1k stars), npm Package Publisher (klaudworks/universal-skills, 181 stars), ccLoad Release Publisher (caidaoli/ccLoad, 419 stars) and Push and PyPI Release (liaohch3/claude-tap, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Navigating GitHub?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.