skills.rest
Priivacy-ai
Priivacy-aiOFFICIAL
Explore all skills by this author →
GitHub

spk-admin-git-workflow

Operates Spec Kitty git workflows, worktrees, safe commits, and merge preflights.

1.6k|156|Updated Oct 9, 2025
Search Tags:#Git#worktree#recovery#spec-kitty#safe commit#Merge#Branch management
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-admin-git-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spk-admin-git-workflow
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-admin-git-workflow
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-admin-git-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git operations inside Spec Kitty missions can corrupt worktrees, lose user changes, or leave stale branch state when handled ad hoc. This Skill provides a governed procedure for running git operations safely within the Spec Kitty workflow.

Core Features & Use Cases

  • Worktree Lifecycle Management: Inspect the active mission, branch, worktree, and target branch before performing any git operation.
  • Safe Commits and Merge Preflights: Route git operations through the Spec Kitty CLI when available and check for merge blockers before merging.
  • Stale State and Recovery Handling: Detect stale repository state and hand off to spk-gate-merge or spk-run-blocked-recovery after repair.
  • Use Case: An agent working in an isolated worktree under .worktrees/ finishes a work package and needs to commit and merge; this Skill ensures the commit is safe, blockers are checked, and user changes are preserved.

Quick Start

Ask the agent to inspect the current Spec Kitty worktree and branch state, then run a safe commit and merge preflight for the active mission.

Frequently Asked Questions about spk-admin-git-workflow

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

FAQPage Schema
How do I safely commit changes in a Spec Kitty worktree?▼

Inspect the active mission, branch, worktree, and target branch first, then let Spec Kitty-managed git operations run through the CLI when available. Perform manual git operations only when the workflow explicitly requires it, and always preserve user changes.

How do I check for merge blockers before merging a work package?▼

Run a merge preflight as part of the git workflow: verify branch state, worktree status, and target branch before merging. After any repair, return to the spk-gate-merge skill to complete the merge gate.

What should I do when Spec Kitty repository state is stale?▼

Detect the stale state during inspection, avoid destructive repair, and preserve user changes. After repairing, hand off to spk-run-blocked-recovery or spk-gate-merge depending on whether the mission is blocked or ready to merge.

When should I use manual git commands instead of the Spec Kitty CLI?▼

Use manual git operations only when the workflow explicitly requires it. The default path is to let Spec Kitty-managed git operations run through the CLI, which keeps mission state and worktree lifecycle consistent.

Does this skill work with the legacy spec-kitty-git-workflow skill?▼

Yes, spec-kitty-git-workflow is a legacy alias. Use it when available for detailed git operation matrices and safe-commit guidance beyond the core flow.

Related Skills

Explore More Software Engineering Skills→
modu-aimodu-ai
1.2k

moai-alfred-spec-metadata-validation

Validate SPEC YAML frontmatter for required fields and HISTORY compliance.

Official
Basic
dbc-oduffydbc-oduffy
5

finishing-a-development-branch

Verify tests and present three branch completion options.

Community
Intermediate
NodeJSmithNodeJSmith
1

mine.wp

Move work packages between planned, doing, for_review, and done lanes.

Community
Intermediate
JongsixJongsix

moai-workflow-worktree

Manage isolated Git worktrees for parallel SPEC development.

Community
Advanced