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
npx skills add alfredoperez/speckit-companion --skill speckit-git-remote -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/speckit-git-remote/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/speckit-git-remote/
1Skills CLI (Vercel)
npx skills add alfredoperez/speckit-companion --skill speckit-git-remote -a codex2Manually: put the files in place
.agents/skills/speckit-git-remote/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alfredoperez/speckit-companion --skill speckit-git-remote -a cursor2Manually: put the files in place
.cursor/skills/speckit-git-remote/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alfredoperez/speckit-companion .claude/skills/speckit-git-remote2Manually: put the files in place
.github/skills/speckit-git-remote/SKILL.md1Skills CLI (Vercel)
npx skills add alfredoperez/speckit-companion --skill speckit-git-remote -a gemini-cli2Platform CLI
gemini skills install https://github.com/alfredoperez/speckit-companion --path .claude/skills/speckit-git-remoteManually: put the files in place
.devin/skills/speckit-git-remote/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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