Back to Skills

git-st

verified

Check development status - uncommitted changes, last commit, beads tasks, and PR status

View on GitHub

Marketplace

brockhoff-tools

kbrockhoff/brockhoff-tools-claude

Plugin

bkff-git

Repository

kbrockhoff/brockhoff-tools-claude

plugins/bkff-git/skills/git-st/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/kbrockhoff/brockhoff-tools-claude/blob/main/plugins/bkff-git/skills/git-st/SKILL.md -a claude-code --skill git-st

Installation paths:

Claude
.claude/skills/git-st/
Powered by add-skill CLI

Instructions

# Git Status Check

Displays comprehensive status of the current git worktree including:
- Uncommitted changes (staged and unstaged)
- Last commit information
- In-progress beads tasks
- Pull request status

## Usage

```
/bkff:git-st
```

No arguments required. Operates on the current working directory.

## Output Sections

### Working Directory
Shows the current branch name and a summary of changes:
- Number of staged files
- Number of unstaged files
- Number of untracked files

### Staged/Unstaged Changes
Lists files with their status:
- `A` - Added (new file)
- `M` - Modified
- `D` - Deleted
- `R` - Renamed
- `?` - Untracked

### Last Commit
Shows information about the most recent commit:
- Short hash
- Commit message
- Author name
- Relative date

### Beads Task
Shows any in-progress beads issues associated with the current work.

### Pull Request
If a PR exists for the current branch, shows:
- PR number and title
- Status (open/closed/merged)
- Check status (passing/failing/pending)
- URL link

## Requirements

- Must be run inside a git worktree
- `git` CLI for status and commit info
- `gh` CLI for PR status (optional - graceful fallback)
- `bd` CLI for beads task status (optional - graceful fallback)

## Examples

### With Changes
```
## Git Status

### Working Directory
- **Branch**: feature/auth-login
- **Status**: 3 files changed (2 staged, 1 unstaged)

### Staged Changes
  A  src/new-file.ts
  M  src/auth.ts

### Unstaged Changes
  M  README.md

### Last Commit
- **Hash**: abc1234
- **Message**: feat(auth): add login endpoint
- **Date**: 2 hours ago

### Pull Request
- **PR #42**: Add authentication feature
- **Status**: Open (checks passing)
```

### Clean State
```
## Git Status

### Working Directory
- **Branch**: main
- **Status**: Clean (no uncommitted changes)

### Last Commit
- **Hash**: def5678
- **Message**: chore: update dependencies
- **Date**: 1 day ago

### Pull Request
- No PR exists for this branch
```

## Implementation

```bash
#!/usr/bi

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
5257 chars