How do I install the Vcs Detect skill?

Run npx skillmds@latest add tomevault-io/vcs-detect in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Vcs Detect safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Vcs Detect?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Vcs Detect free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Vcs Detect?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Vcs Detect by tomevault-io — Agent Skill

Name: Vcs Detect
Author: tomevault-io

File contents

VCS Detection Skill

Detect the version control system in use before running any VCS commands.

Why This Matters

jj (Jujutsu) and git have different CLIs and workflows
Running git commands in a jj repo (or vice versa) causes errors
Some repos use jj with git colocated (both .jj/ and .git/ exist)

Detection Logic

Both jj root and git rev-parse --show-toplevel walk up the filesystem to find repo root.

Priority order:

jj root succeeds → jj (handles colocated too)
git rev-parse succeeds → git
Both fail → no VCS

Detection Command

if jj root &>/dev/null; then echo "jj"
elif git rev-parse --show-toplevel &>/dev/null; then echo "git"
else echo "none"
fi

Command Mappings

Operation	git	jj
Status	`git status`	`jj status`
Log	`git log`	`jj log`
Diff	`git diff`	`jj diff`
Commit	`git commit`	`jj commit` / `jj describe`
Branch list	`git branch`	`jj branch list`
New branch	`git checkout -b <name>`	`jj branch create <name>`
Push	`git push`	`jj git push`
Pull/Fetch	`git pull` / `git fetch`	`jj git fetch`
Rebase	`git rebase`	`jj rebase`

Usage

Before any VCS operation:

Run detection command
Use appropriate CLI based on result
If none, warn user directory is not version controlled

Example Integration

User: Show me the git log
Agent: [Runs detection] -> Result: jj
Agent: [Runs `jj log` instead of `git log`]

Colocated Repos

When both .jj/ and .git/ exist, the repo is "colocated":

jj manages the working copy
git is available for compatibility (GitHub, etc.)
Always prefer jj commands in colocated repos

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: vcs-detectdescription: Detect whether the current project uses jj (Jujutsu) or git for version control. Run this BEFORE any VCS command to use the correct tool. Use when this capability is needed.---# VCS Detection SkillDetect the version control system in use before running any VCS commands.## Why This Matters- jj (Jujutsu) and git have different CLIs and workflows- Running `git` commands in a jj repo (or vice versa) causes errors- Some repos use jj with git colocated (both `.jj/` and `.git/` exist)## Detection LogicBoth `jj root` and `git rev-parse --show-toplevel` walk up the filesystem to find repo root.**Priority order:**1. `jj root` succeeds → jj (handles colocated too)2. `git rev-parse` succeeds → git3. Both fail → no VCS## Detection Command```bashif jj root &>/dev/null; then echo "jj"elif git rev-parse --show-toplevel &>/dev/null; then echo "git"else echo "none"fi```## Command Mappings| Operation | git | jj || ----------- | ------------------------ | --------------------------- || Status | `git status` | `jj status` || Log | `git log` | `jj log` || Diff | `git diff` | `jj diff` || Commit | `git commit` | `jj commit` / `jj describe` || Branch list | `git branch` | `jj branch list` || New branch | `git checkout -b <name>` | `jj branch create <name>` || Push | `git push` | `jj git push` || Pull/Fetch | `git pull` / `git fetch` | `jj git fetch` || Rebase | `git rebase` | `jj rebase` |## UsageBefore any VCS operation:1. Run detection command2. Use appropriate CLI based on result3. If `none`, warn user directory is not version controlled## Example Integration```User: Show me the git logAgent: [Runs detection] -> Result: jjAgent: [Runs `jj log` instead of `git log`]```## Colocated ReposWhen both `.jj/` and `.git/` exist, the repo is "colocated":- jj manages the working copy- git is available for compatibility (GitHub, etc.)- **Always prefer jj commands** in colocated repos---> Converted and distributed by [TomeVault](https://tomevault.io/claim/nrminor) — claim your Tome and manage your conversions.

Frequently asked questions

Vcs Detect