skills.rest
handarbeit
handarbeitOFFICIAL
Explore all skills by this author →
GitHub

fabrik-status

Inspect Fabrik project board state, running Claude workers, and worktree changes.

22|Updated Apr 1, 2026
Search Tags:#monitoring#worktrees#github#claude code#graphql#project board#status check
One-click install
npx skills add https://github.com/handarbeit/fabrik --skill fabrik-status-handarbeit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fabrik-status
Source: https://github.com/handarbeit/fabrik/tree/main/.claude/skills/fabrik-status
Command: npx skills add https://github.com/handarbeit/fabrik --skill fabrik-status-handarbeit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running Fabrik to drive Claude Code through a GitHub Project board, it is hard to know at a glance what the system is doing: which issues are in which stage, which workers are active, and whether anything is stuck or has uncommitted changes. This Skill gathers all of that into one concise status summary. ## Core Features & Use Cases - Worker Detection: Finds running Claude Code worker processes via ps aux filtering. - Board Inspection: Queries the GitHub GraphQL API to list issues by board column, flag issues with fabrik:editing or fabrik:locked labels, and show open PRs with mergeable status. - Worktree Hygiene Check: Scans .fabrik/worktrees/issue-* directories for uncommitted changes. - Use Case: You return to your desk and ask "what is Fabrik doing right now?" — the Skill reports active workers, board distribution, locked issues, and dirty worktrees so you know exactly what needs attention. ## Quick Start Ask the assistant to check the current Fabrik project status and summarize what needs attention.

Frequently Asked Questions about fabrik-status

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

FAQPage Schema
How do I check the status of a Fabrik project board?▼

Run the fabrik-status skill, which queries the GitHub GraphQL API via the gh CLI to list issues grouped by board column. It also highlights issues carrying fabrik:editing or fabrik:locked labels and shows open PRs with their mergeable status.

How to find running Claude Code worker processes?▼

Use `ps aux | grep "claude.*print" | grep -v grep` to list active Claude workers spawned by Fabrik. The skill runs this automatically and includes the results in its status summary.

Can I check for uncommitted changes in Fabrik worktrees?▼

Yes. The skill iterates over `.fabrik/worktrees/issue-*/` directories and runs `git status --short` in each, surfacing any worktree with uncommitted changes that may indicate interrupted or stuck work.

What do fabrik:editing and fabrik:locked labels mean?▼

These labels mark issues currently being edited or locked by Fabrik workers, signaling work in progress. The status check explicitly surfaces issues with these labels so you can spot potential contention or stuck items.

Why does the board query require the gh CLI?▼

The skill uses `gh api graphql` to fetch project board data from GitHub's GraphQL API, which requires the GitHub CLI to be installed and authenticated with appropriate repo and project scopes.

Related Skills

Explore More Software Engineering Skills→
sarkarshivaditya-labsarkarshivaditya-lab

session-start

Establishes session context by checking GitHub project state, repository status, and memory before work.

Community
Advanced
philipp-spiessphilipp-spiess

review

Review uncommitted repository changes with codex review --uncommitted.

Community
Basic
ZaxbyHubZaxbyHub
437

swarm-pr-feedback

Resolve pull request feedback with verified source evidence and closure summaries.

Official
Advanced
gsd-buildgsd-build
7.8k

gh

Install, configure, and operate the GitHub CLI for issues, PRs, milestones, and Projects V2.

Official
Advanced