speckit-git-remote

Detect the Git remote URL and parse GitHub owner and repository.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Congtrinhh/sholy-be --skill speckit-git-remote-congtrinhh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-remote
Source: https://github.com/Congtrinhh/sholy-be/tree/main/.agents/skills/speckit-git-remote
Command: npx skills add https://github.com/Congtrinhh/sholy-be --skill speckit-git-remote-congtrinhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of determining the Git remote URL so GitHub-oriented automation (like issue creation) can correctly identify the repository you are working on.

Core Features & Use Cases

  • Remote URL detection: Reads the configured Git origin remote URL to identify where the current repo points.
  • GitHub repository parsing: Extracts the repository owner and name and verifies the remote actually targets github.com before reporting.
  • Graceful fallback: Returns an empty result when Git is unavailable, the directory is not a Git repo, or no remote is configured.

Example use case: You are running an automation inside a local clone and want it to reliably resolve the GitHub owner/repo for creating issues or linking artifacts to the correct repository.

Quick Start

Use the skill to detect the GitHub owner and repository for your current working directory using its configured origin remote.

Frequently Asked Questions about speckit-git-remote

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

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

To get the GitHub repository owner and name, the skill runs git config --get remote.origin.url and parses the output. It extracts the owner and repository from supported HTTPS and SSH GitHub URL formats after verifying the remote targets github.com.

What happens if git remote detection fails in a directory that is not a repository?

If git remote detection fails, the skill returns an empty result. It gracefully falls back when Git is unavailable, the working directory is not a Git repository, or no origin remote is configured.

Does the remote URL parser support both SSH and HTTPS GitHub formats?

Yes, the remote URL parser supports both SSH and HTTPS GitHub formats. It reads the configured origin remote and extracts the repository owner and name after verifying the remote actually targets github.com.

How can I automatically link GitHub issues to my current working repository?

You can link GitHub issues by detecting the Git remote URL to identify the correct repository. The skill resolves the local repository context by reading the .specify/ structure and parsing the origin remote URL.

Why does my GitHub integration workflow need to run git rev-parse before creating issues?

Running git rev-parse verifies the Git context before attempting to read the remote URL. This ensures the working directory is a valid Git repository so the GitHub integration can reliably map issue context to the correct repository.