detect-upstream-base

This skill identifies the upstream vLLM tag that a forked branch is based on by configuring the upstream remote, fetching tags, and finding the nearest tagged…

by CohereOfficial publisherNot reviewed

Identity proven by GitHub's verified organisation badge (cohere-ai)

Agents: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, claude.ai and API
License: Apache-2.0 (permissive)
Pin: 2a9ed1fpinned Oct 9, 2026
Context cost: about 220 tokenswhen the skill loads
GitHub stars: 6on cohere-ai/vllm-skills
Scripts: None found

What it does

“Detect the upstream vllm tag (v1) that the current branch is based on. Ensures the upstream remote is configured, fetches tags, and finds the nearest upstream tag reachable from the fork point. Use when you need to identify the upstream base version of the current branch, or when another skill needs v1 detection.”

The author's description, from SKILL.md

Generated summary from the skill's own text

This skill identifies the upstream vLLM tag that a forked branch is based on by configuring the upstream remote, fetching tags, and finding the nearest tagged version from the fork point. It presents the detected tag to the user for confirmation before returning the upstream base version.

When to use it

Determining which upstream vLLM release a feature branch originated from
Validating compatibility when another skill requires upstream version information
Identifying the base tag for comparing changes between fork and upstream

When not to

Working with non-vLLM repositories or forks without upstream remotes
When exact commit history is less important than current branch state

Install

These commands install from the publisher's repository and need no account.

skills CLI

npx skills add cohere-ai/vllm-skills --skill detect-upstream-base

Installs from the repository's default branch, which may have changed since the commit we checked.

GitHub CLI 2.90 or later

gh skill install cohere-ai/vllm-skills detect-upstream-base@2a9ed1ff5dd822a521a453f49eff84e8dd5a7071

Installs the commit we checked (2a9ed1f).

Copy by hand

Download the folder at 2a9ed1f and put it in .claude/skills/detect-upstream-base for Claude Code and in .agents/skills/detect-upstream-base for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.

Skill folder on GitHub at 2a9ed1f

Copy for your agent

A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.

Prompt

Install the agent skill "detect-upstream-base" by Cohere.

Source, pinned to commit 2a9ed1ff5dd822a521a453f49eff84e8dd5a7071:
https://github.com/cohere-ai/vllm-skills/tree/2a9ed1ff5dd822a521a453f49eff84e8dd5a7071/skills/detect-upstream-base

1. Download that folder at exactly this commit. Do not use the default branch.
2. Copy every file unchanged, keeping the folder structure, into .claude/skills/detect-upstream-base/ for Claude Code and .agents/skills/detect-upstream-base/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist.
3. Do not edit the files, and do not run any script in the folder unless I ask you to.
4. When you are done, list the files you copied and where you put them.

Listing and checks: https://www.agentnative.dev/skills/cohere/detect-upstream-base

SKILL.md at the pin

---
name: detect-upstream-base
description: >-
  Detect the upstream vllm tag (v1) that the current branch is based on.
  Ensures the upstream remote is configured, fetches tags, and finds the
  nearest upstream tag reachable from the fork point. Use when you need to
  identify the upstream base version of the current branch, or when another
  skill needs v1 detection.
---

# Detect Upstream Base Tag

Determine which upstream vllm tag the current branch is forked from.

## Usage

### Step 1: Ensure upstream remote

```bash
if ! git remote get-url upstream &>/dev/null; then
  git remote add upstream git@github.com:vllm-project/vllm.git
fi
git fetch upstream --tags
```

### Step 2: Detect v1

```bash
V1_BASE=$(git merge-base HEAD upstream/main)
V1=$(git describe --tags --abbrev=0 --match="v*" "$V1_BASE" 2>/dev/null)
```

If `git describe` fails (no reachable tag), fall back to the merge-base SHA:
```bash
V1=${V1:-$V1_BASE}
```

### Step 3: Confirm with user

Present to user: "The current upstream base tag appears to be **$V1**. Is
this correct, or would you like to specify a different tag?"

Wait for explicit confirmation before returning the value.

## Output

The confirmed value of `V1` (an upstream tag like `v0.19.1` or a commit SHA).

From cohere-ai/vllm-skills at 2a9ed1f, shown as plain text under its license: Apache-2.0 (permissive). The license text is in LICENSE.

View SKILL.md on GitHub at 2a9ed1f

Files

SKILL.md1.3 KB · 94f1d63048e3

1 file, 1.3 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.

Skill folder on GitHub at 2a9ed1f

All 6 skills from Cohere

Open roles at Cohere

5 of 41 open roles on the jobs board

Senior Member of Technical Staff, Web Data
Remote (EST/EU) (Remote)
Member of Technical Staff, Modeling
Remote (Remote)
Senior Software Engineer, GPU Infrastructure (HPC)
Remote (Canada | United States) (Remote)
Software Engineer, Data Infrastructure
New York | San Francisco | Canada | United States | Toronto | Montreal (Remote)
Audio Inference Engineer, Model Efficiency
New York, NY, United States | San Francisco, CA, United States | Toronto, ON, Canada | Montreal, QC, Canada (Remote)

See all 41 roles at Cohere on the jobs board

detect-upstream-base

What it does

When to use it

When not to

Install

Copy for your agent

SKILL.md at the pin

Files

More from Cohere

rcp-ndcg

auto-rebase

install-vllm

local-test-runner

rebase-assistant

planning

progressive-building

workflow-builder

remotion-upgrade

remotion-upgrade

final-release-review

Open roles at Cohere

What it does

When to use it

When not to

Install

Copy for your agent

SKILL.md at the pin

Files

More from Cohere

Related in Coding workflow

Open roles at Cohere