Official agent skill

Publishing Docs Versions

by sourcegraph in sourcegraph/docs

Archives Sourcegraph docs release branches and updates latest-version metadata.

OfficialNo licenceAuto-check passed

Install Publishing Docs Versions

skills CLI
$ npx skills add sourcegraph/docs --skill publishing-docs-versions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sourcegraph/docs publishing-docs-versions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sourcegraph/docs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/publishing-docs-versions .claude/skills/publishing-docs-versions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
publishing-docs-versions
GitHub stars
173
Token cost
~1.4k tokens
SKILL.md length
552 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Archives Sourcegraph docs release branches and updates latest-version metadata.

  • Works in 3 steps: Archive the previous docs version P.Q in… → Ensure the legacy branch’s own config… → Update origin so X.Y is latest and P.Q…
  • A new Sourcegraph docs version is released
  • SKILL.md covers Repository conventions, Standard workflow for a new…, Finding the cut point for a… and Creating and pushing the…, plus 2 more sections
  • Calls git and gh; reaches sourcegraph.com

What it does

Publishing Docs Versions is an agent skill from sourcegraph/docs, published by the product's own GitHub organization. Archives Sourcegraph docs release branches and updates latest-version metadata. Use when a new Sourcegraph docs version is released, when creating docs legacy branches, or when updating DOCSLATESTVERSION and previous-version lists.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Web app and content for the new Sourcegraph documentation.

When your agent uses it

  • A new Sourcegraph docs version is released
  • Creating docs legacy branches
  • Updating DOCSLATESTVERSION and previous-version lists

Example prompts

  • “Use the publishing-docs-versions skill to archive Sourcegraph docs release branches and updates latest-version metadata”
  • “/publishing-docs-versions”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Archive the previous docs version P.Q in the legacy remote.
  2. Ensure the legacy branch’s own config says it is version P.Q, marks it as
  3. Update origin so X.Y is latest and P.Q appears as a previous version.

What it can do on your machine

Read from SKILL.md and the folder at commit 1a1a551. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • sourcegraph.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Publishing Docs Versions loads about 1.4k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 552 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 552 words (~1,363 tokens).

“Use this skill for the Sourcegraph docs repo release-version workflow: cutting legacy branches in the legacy remote and updating origin so the newest version becomes latest.”

— opening of SKILL.md by sourcegraph
name
publishing-docs-versions

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/publishing-docs-versions of sourcegraph/docs.

Open the folder on GitHubat commit 1a1a551

Compare with similar skills

Publishing Docs Versions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Publishing Docs Versions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Publishing Docs Versions this skillsourcegraph/docs173—~1.4kAutomated safety check: PassNone
Update Versionremotion-dev/remotion62k—~231Automated safety check: PassCustom licence
Update V8 Versionopeninterpreter/openinterpreter69k2 repos~845Automated safety check: PassApache-2.0
Publishcode-yeongyu/oh-my-openagent70k—~5.5kAutomated safety check: WarnCustom licence
Update Release Notes Branch Setdotnet/core22k—~1.7kAutomated safety check: PassMIT
Social Publisheraffaan-m/ECC274k1 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Update Version

    remotion-dev/remotion

    Official

    Update AvailableFrom in a PR to the next Remotion patch version (main + 0.0.1).

    62k GitHub stars~231 tokensUpdated today
    Media & CreativeAuto-check passed
  • Update V8 Version

    openinterpreter/openinterpreter

    Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.

    69k GitHub starsUsed in 2 repos~845 tokens
    DevOps & CloudAuto-check passed
  • Publish

    code-yeongyu/oh-my-openagent

    Publish oh-my-opencode to npm by triggering the GitHub Actions publish workflow and verifying its artifacts.

    70k GitHub stars~5.5k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Official

    Refreshes an existing .NET release-notes milestone branch set incrementally, regenerating data only when the preview moved and keeping human edits and review replies.

    22k GitHub stars~1.7k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Social Publisher

    affaan-m/ECC

    Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw.

    274k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Guides updating dependency versions in published packages to avoid mono-repo resolution failures.

    1.7k GitHub stars~556 tokensUpdated yesterday
    DevelopmentAuto-check passed

Questions about Publishing Docs Versions

What does Publishing Docs Versions do?

Archives Sourcegraph docs release branches and updates latest-version metadata. Publishing Docs Versions is an agent skill from sourcegraph/docs, published by the product's own GitHub organization. Archives Sourcegraph docs release branches and updates latest-version metadata.

When should I use Publishing Docs Versions?

Publishing Docs Versions fits situations like: A new Sourcegraph docs version is released; creating docs legacy branches; updating DOCSLATESTVERSION and previous-version lists.

How do I install Publishing Docs Versions in Claude Code?

Run `npx skills add sourcegraph/docs --skill publishing-docs-versions -a claude-code`. Or copy the skill folder (.agents/skills/publishing-docs-versions in sourcegraph/docs) into .claude/skills/publishing-docs-versions in your project. Claude Code loads it when a task matches its description.

How do I install Publishing Docs Versions in Codex?

Run `npx skills add sourcegraph/docs --skill publishing-docs-versions -a codex`. Or copy the skill folder (.agents/skills/publishing-docs-versions in sourcegraph/docs) into .agents/skills/publishing-docs-versions in your project. Codex loads it when a task matches its description.

Can I use Publishing Docs Versions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sourcegraph/docs --skill publishing-docs-versions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/publishing-docs-versions, .gemini/skills/publishing-docs-versions, .github/skills/publishing-docs-versions and .opencode/skills/publishing-docs-versions in your project.

What does Publishing Docs Versions need to run?

Going by SKILL.md and its folder, Publishing Docs Versions needs the command-line tools its instructions call (git and gh).

Does Publishing Docs Versions access the network?

SKILL.md names 1 domain. In commands or code: sourcegraph.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Publishing Docs Versions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Publishing Docs Versions use?

No licence was found for Publishing Docs Versions or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Publishing Docs Versions use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Publishing Docs Versions?

Skills that share tags, products or a category with Publishing Docs Versions: Update Version (remotion-dev/remotion, 62k stars), Update V8 Version (openinterpreter/openinterpreter, 69k stars), Publish (code-yeongyu/oh-my-openagent, 70k stars) and Update Release Notes Branch Set (dotnet/core, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Publishing Docs Versions?

sourcegraph (a GitHub organization, an official publisher) maintains it in sourcegraph/docs, which has 173 GitHub stars. The repository was last updated on October 6, 2026.

Source: sourcegraph/docs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.