ws-context

Describe the active branch, worktrees, and bare clone layout of a ws workspace.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/langify-org/ws-cli --skill ws-context
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ws-context
Source: https://github.com/langify-org/ws-cli/tree/main/plugin/skills/ws-context
Command: npx skills add https://github.com/langify-org/ws-cli --skill ws-context

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ws-context helps developers understand and communicate the current state of a ws-managed workspace, including the active worktree, branches, and repository layout, without running potentially destructive git commands.

Core Features & Use Cases

  • Contextual workspace view: summarizes the active branch, worktrees, and bare clone layout for quick orientation.
  • Safe guidance: answers questions like "which branch am I on" and "what worktrees exist" without performing actions.
  • Project layout awareness: explains how the repository is structured (bare clone, worktrees, store directory) to aid debugging and onboarding.

Quick Start

Describe the current ws workspace state for the active repository.

Frequently Asked Questions about ws-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check which git branch I am currently on in a ws-managed workspace?

To check which git branch you are on, ws-context reads the active repository state and summarizes the active worktree, branch, and bare clone layout without running destructive commands. It provides a concise overview for quick orientation.

What is the best way to list all existing git worktrees in a bare clone repository?

The best way to list existing git worktrees is using ws-context to read the bare clone layout and summarize all active worktrees. It reads repository state to provide a safe, concise overview without performing actions.

How does a bare clone repository layout work with git worktrees?

A bare clone repository layout stores the central git history separately, allowing worktrees to act as independent working directories. ws-context explains this structure, including the store directory, to aid debugging and onboarding.

Can I view my workspace state without running potentially destructive git commands?

Yes, you can safely view your workspace state without destructive git commands by using ws-context. It reads repository state and workspace structure to provide contextual guidance and summarize the active branch and worktrees.

How do I understand the repository state and store directory layout for project onboarding?

To understand the repository state for onboarding, ws-context provides project layout awareness by explaining how the bare clone, worktrees, and store directory are structured, helping new developers quickly orient themselves.