skills.rest
nebinfra
nebinfraOFFICIAL
Explore all skills by this author →
Website𝕏@nebinfraGitHub

neb-ws-diagnose

Diagnose and repair corrupted Git workspaces and submodule states.

Updated Aug 27, 2026
Search Tags:#automation#git#workspace#diagnostics#recovery#diagnose#submodules
One-click install
npx skills add https://github.com/nebinfra/nebcore-ai-skills --skill neb-ws-diagnose
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neb-ws-diagnose
Source: https://github.com/nebinfra/nebcore-ai-skills/tree/main/neb-ws-diagnose
Command: npx skills add https://github.com/nebinfra/nebcore-ai-skills --skill neb-ws-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect and repair corrupted workspace state to improve reliability of the platform orchestrator.

Core Features & Use Cases

  • 7 diagnostic checks across root and submodules (locks, detached HEAD, pointer drift, unmerged branches, dirty state, branch state, and remote sync) to identify issues and propose fixes.
  • Safe auto-repair workflow with non-destructive options reported for manual action when needed.

Quick Start

Run the skill against a Git workspace path to start a diagnostic and auto-repair workflow.

Frequently Asked Questions about neb-ws-diagnose

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

FAQPage Schema
How do I diagnose and repair a corrupted git workspace with detached heads and submodule pointer drift?▼

To diagnose and repair a corrupted git workspace, run a systematic diagnostic workflow that checks git locks, detached heads, and submodule pointer drift, then applies safe, non-destructive auto-repairs or reports issues for manual action.

What is the best way to fix git locks and unmerged branches in a multi-submodule monorepo?▼

The best way to fix git locks and unmerged branches in a multi-submodule monorepo is using a diagnostic tool that performs seven systematic checks across root and submodules, proposing safe auto-repairs or detailed manual action reports.

Can I automatically recover a dirty git submodule state without losing uncommitted changes?▼

Yes, you can recover a dirty git submodule state without losing changes by using a safe auto-repair workflow that prioritizes non-destructive options and generates detailed issue reports for any manual action needed.

Does git workspace diagnostics support branch misalignment and remote sync checks across all submodules?▼

Git workspace diagnostics supports branch misalignment and remote sync checks across all submodules by applying seven systematic checks to both the root repository and nested submodule states.

When should I manually resolve workspace corruption instead of using automated git recovery?▼

You should manually resolve workspace corruption when the automated diagnostic tool detects complex unmerged branches or remote sync conflicts, reporting detailed issues that require manual action rather than safe non-destructive auto-repairs.

Related Skills

Explore More Software Engineering Skills→
jaydubya818jaydubya818

installing-skills-from-github

Install GitHub repository skills as git submodules with .gitignore conflict resolution.

Community
Intermediate
carl10086carl10086
7

ci-cd-and-automation

Configure CI/CD pipelines with automated quality gates and deployment strategies.

Community
Advanced
open-haxopen-hax
6

git-safety-check

Check git branch, working tree, remotes, and submodules before destructive operations.

Official
Intermediate
fyrsmithlabsfyrsmithlabs

agent-artifacts

Route agent-generated artifacts to docs/.claude/ subdirectories.

Official
Basic