Skip to main content
skill CX Codex

speckit-git-remote — Claude Code skill: what it does, how to install

speckit-git-remote detects the Git remote URL and verifies GitHub connectivity for tasks like issue creation in spec-kit workflows. Designed for repositories structured with a .specify/ directory.

MIT ★ 110 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add alfredoperez/speckit-companion --skill speckit-git-remote -a claude-code
Open on GitHub

What speckit-git-remote does

The skill checks whether the current folder is inside a Git tree via git rev-parse --is-inside-work-tree, then queries git config --get remote.origin.url. It extracts the repository owner and repository name, supporting both HTTPS and SSH origin addresses.

A remote is marked as GitHub only when it explicitly points to github.com. If Git is missing, not configured, or run outside a Git workspace, the skill issues a warning and degrades gracefully by returning an empty string without halting the workflow.

This tool requires a spec-kit project layout with a .specify/ directory to function.

What it helps with

  • Extract repository owner and project name from the configured Git origin URL
  • Verify whether the remote address points specifically to GitHub before calling APIs
  • Parse HTTPS and SSH remote URLs to feed GitHub metadata into spec-kit workflows
  • Supply repository coordinates for automated issue creation without throwing errors

Example prompts for the agent

  • Detect the Git remote URL and check whether this project is hosted on GitHub.
  • Read the origin remote configuration to extract the repository owner and project name.
  • Check the current Git workspace and retrieve the remote URL for GitHub issue integration.

How to install speckit-git-remote

1Skills CLI (Vercel)

npx skills add alfredoperez/speckit-companion --skill speckit-git-remote -a claude-code

2Manually: put the files in place

~/.claude/skills/speckit-git-remote/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/speckit-git-remote/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about speckit-git-remote

How to install speckit-git-remote in Claude Code?

Run npx skills add alfredoperez/speckit-companion --skill speckit-git-remote -a claude-code.

What does speckit-git-remote do?

It reads the remote URL using git config, parses the repository owner and name, and verifies whether the remote points to github.com.

What happens if the skill runs outside a Git repository?

The skill emits a warning message and safely returns an empty result instead of throwing an error or stopping the workflow.

Source text

SKILL.md · MIT
---
name: speckit-git-remote
description: Detect Git remote URL for GitHub integration
compatibility: Requires spec-kit project structure with .specify/ directory
metadata:
  author: spec-kit-core
  source: extension:git
user-invocable: true
disable-model-invocation: false
---

# Git Remote Skill

# Detect Git Remote URL

Detect the Git remote URL for integration with GitHub services (e.g., issue creation).

## Prerequisites

- Check if Git is available by running `git rev-parse --is-inside-work-tree 2>/dev/null`
- If Git is not available, output a warning and return empty:
  ```
  [specify] Warning: Git repository not detected; cannot determine remote URL
  ```

## Execution

Run the following command to get the remote URL:

```bash
git config --get remote.origin.url
```

## Output

Parse the remote URL and determine:

1. **Repository owner**: Extract from the URL (e.g., `github` from `https://github.com/github/spec-kit.git`)
2. **Repository name**: Extract from the URL (e.g., `spec-kit` from `https://github.com/github/spec-kit.git`)
3. **Is GitHub**: Whether the remote points to a GitHub repository

Supported URL formats:
- HTTPS: `https://github.com/<owner>/<repo>.git`
- SSH: `[email protected]:<owner>/<repo>.git`

> [!CAUTION]
> ONLY report a GitHub repository if the remote URL actually points to github.com.
> Do NOT assume the remote is GitHub if the URL format doesn't match.

## Graceful Degradation

If Git is not installed, the directory is not a Git repository, or no remote is configured:
- Return an empty result
- Do NOT error — other workflows should continue without Git remote information

© spec-kit-core · MIT · alfredoperez/speckit-companion

Similar skills

All skills for Git and GitHub →

From the same set83

The whole set →
speckit.taskstoissues speckit.taskstoissues — a prompt that converts a task list into structured GitHub Issues with dependency ordering. Works with design artifacts and requires GitHub MCP server access. CX Codex GP ChatGPT ★ 110repo stars speckit.git.remote speckit.git.remote detects the Git remote origin URL, parses repository ownership, and validates github.com hosts for downstream workflows. CX Codex +1 ★ 110repo stars cleanup-reviewer cleanup-reviewer reviews a specified slice of a repository cleanup diff and reports findings only. Use it when the review should stay within named files. CX Codex ★ 110repo stars speckit.git.initialize The speckit.git.initialize command sets up a Git repository in your project and creates an initial commit if one doesn't exist. Use it when starting a new project or preparing a template. CX Codex +1 ★ 110repo stars speckit-git-initialize speckit-git-initialize creates a Git repository in the current project and makes its first commit. It fits spec-kit projects that need Git initialized. CX Codex +1 ★ 110repo stars speckit.git.validate speckit.git.validate — a command that checks whether your current Git branch follows project naming conventions for feature branches. Install it if your team uses structured branch prefixes and wants to automate validation. CX Codex +1 ★ 110repo stars cleanup-implementer cleanup-implementer executes a single repository cleanup work packet. It edits assigned files, runs target checks, and never touches git write operations. CX Codex ★ 110repo stars bench-prep bench-prep is a command for Claude Code and Codex that resets three test cells to baseline and assigns them one task size before an agent works through the SpecKit Companion workflow. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open