Skill: Detecting Repository Type

When to Use This Skill

Use when determining fork vs origin, extracting owner/repo names, identifying sync/push/PR strategy, or when another skill needs repository structure.

Invoked by: creating-pull-request (PR target/head), syncing-branch (sync strategy), rebasing-branch (remote config).

Workflow Description

Analyzes git remote configuration to determine fork (has upstream) vs origin-only. Extracts owner/repo from remote URLs for GitHub API operations.

Phase 1: Check for Upstream Remote

Objective: Detect fork scenario by checking for upstream remote.

Steps:

1. Check for upstream remote:

   git remote get-url upstream
   

2. Check exit code:

   • Exit 0: Upstream exists (FORK scenario)
   • Exit 128/2: No upstream (ORIGIN scenario)

Validation Gate: Remote Detection

IF exit code is 0: Set is_fork = true Capture upstream_url Continue to Phase 2 (Fork Path)

IF exit code is non-zero: Set is_fork = false Continue to Phase 2 (Origin Path)

Phase 1 complete. Continue to Phase 2.

Phase 2: Get Remote URLs

Objective: Retrieve all relevant remote URLs based on repository type.

Fork Scenario (is_fork = true):

Steps:

1. Get upstream URL:

   git remote get-url upstream
   

2. Get origin URL:

   git remote get-url origin
   

Capture: upstream_url, origin_url

Origin Scenario (is_fork = false):

Steps:

1. Get origin URL:

   git remote get-url origin
   

Capture: origin_url

Validation Gate: URLs Retrieved

IF all required URLs successfully retrieved: Continue to Phase 3

IF URL retrieval fails: STOP immediately EXPLAIN: "Cannot retrieve remote URLs" PROPOSE: "Verify remote configuration with git remote -v" RETURN: Error state to invoking skill

Phase 2 complete. Continue to Phase 3.

Phase 3: Parse Remote URLs

Objective: Extract owner and repository names from URLs.

Steps:

1. Parse URLs using bash to handle both SSH and HTTPS formats:

   SSH format: git@github.com:owner/repo.git HTTPS format: https://github.com/owner/repo.git

   Parsing command:

   echo "$URL" | sed 's|git@github.com:||; s|https://github.com/||; s|\.git$||'
   

   This produces: owner/repo

2. Split on / to extract:

   • owner (first part before /)
   • repo (second part after /)

3. Apply to each URL based on repository type

Fork Scenario (is_fork = true):

Parse both upstream and origin URLs:

• upstream_owner, upstream_repo
• origin_owner, origin_repo

Origin Scenario (is_fork = false):

Parse origin URL only:

• origin_owner, origin_repo

Validation Gate: Parsing Success

IF all owner/repo pairs successfully extracted: Continue to Phase 4

IF parsing fails: STOP immediately EXPLAIN: "Cannot parse owner/repo from remote URLs" SHOW: URLs that failed to parse RETURN: Error state to invoking skill

Phase 3 complete. Continue to Phase 4.

Phase 4: Build Result Structure

Objective: Return structured repository information to invoking skill.

Return structured result:

{
  "is_fork": <true|false>,
  "upstream": { # only present if is_fork = true
    "url": "<upstream_url>",
    "owner": "<upstream_owner>",
    "repo": "<upstream_repo>"
  },
  "origin": {
    "url": "<origin_url>",
    "owner": "<origin_owner>",
    "repo": "<origin_repo>"
  }
}

Phase 4 complete. Workflow complete.