speckit-git-remote

Detect Git remote URLs and derive GitHub owner and repository names from HTTPS or SSH remotes.

Updated May 16, 2026
One-click install
npx skills add https://github.com/WeihanLi/Spark.OpenXml --skill speckit-git-remote-weihanli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-remote
Source: https://github.com/WeihanLi/Spark.OpenXml/tree/main/.agents/skills/speckit-git-remote
Command: npx skills add https://github.com/WeihanLi/Spark.OpenXml --skill speckit-git-remote-weihanli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects the Git remote URL and derives GitHub repository owner and name, enabling automatic mapping of local clones to GitHub projects for automation and integration tasks.

Core Features & Use Cases

  • Retrieve the remote URL from git config using the origin reference
  • Parse owner and repo from the URL and verify whether it points to GitHub
  • Graceful degradation when Git is unavailable, not a repository, or no remote is configured

Quick Start

Run git config --get remote.origin.url to fetch the repository's remote URL and extract the owner and repo.

Frequently Asked Questions about speckit-git-remote

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

FAQPage Schema
How do I extract the GitHub repository owner and name from a local git remote URL?

To extract the GitHub repository owner and name from a local git remote URL, retrieve the origin remote URL via git config and parse the path components. This Skill automates that parsing to map local clones to GitHub projects.

Can I parse both SSH and HTTPS git remote URLs to identify the GitHub repository?

Yes, you can parse both SSH and HTTPS git remote URLs to identify the GitHub repository. The Skill accepts both remote formats, validates github.com as the host, and accurately derives the repository owner and name from either URL structure.

What happens if git is unavailable or no remote is configured when parsing the repository ID?

If git is unavailable, the directory is not a git repository, or no remote is configured when parsing the repository ID, the Skill gracefully degrades and returns an empty result instead of throwing an error.

How do I map a local git clone to a GitHub project for automation workflows?

To map a local git clone to a GitHub project for automation workflows, run git config to fetch the remote.origin.url and derive the owner and repo. This Skill provides the parsed repository details needed for issue creation and integrations.

Does this remote URL parser validate that the host is github.com before extracting the owner and repo?

Yes, the remote URL parser validates that the host is github.com before extracting the owner and repo. It explicitly checks the remote URL host to ensure the local clone points to GitHub before returning repository details.

Why does my git remote parsing return an empty result for repository automation?

Git remote parsing returns an empty result for repository automation if Git is not installed, the current directory is not a Git repository, or no origin remote is configured. The Skill handles these edge cases gracefully without failing.