spec-kitty-git-workflow SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

spec-kitty-git-workflow from wildcard/caro is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wildcard/caro/spec-kitty-git-workflow@git:20260427.b2f2f5b

Pins git:20260427.b2f2f5b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wildcard/caro
Path
.claude/skills/spec-kitty-git-workflow/SKILL.md
Versions recorded
1
Latest version
git:20260427.b2f2f5b, committed Apr 27, 2026
Size
8,682 bytes
Repository stars
40
License
AGPL-3.0

Understand how Spec Kitty manages git: what git operations Python handles automatically, what agents must do manually, worktree lifecycle, auto-commit behavior, merge execution, and the safe-commit pattern. Triggers: "how does spec-kitty use git", "worktree management", "auto-commit", "who commits what", "git workflow", "merge workflow", "rebase WPs", "worktree cleanup", "safe commit". Does NOT handle: runtime loop advancement (use runtime-next), setup or repair (use setup-doctor), mission…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# spec-kitty-git-workflow

Understand the boundary between what spec-kitty's Python code does with git
and what LLM agents are expected to do. This boundary is critical — agents
that try to create worktrees manually or skip implementation commits will
break the workflow.

---

## The Core Boundary

**Python handles infrastructure git** — worktrees, lane commits, merges,
cleanup. **Agents handle content git** — implementation commits, rebases,
conflict resolution.

| Git Operation | Who Does It | When |
|---|---|---|
| `git worktree add` | Python | `spec-kitty implement WP##` |
| `git commit` (planning artifacts) | Python | Before worktree creation |
| `git commit` (lane transitions) | Python | WP moves to doing/for_review |
| `git commit` (implementation code) | **Agent** | After writing code in worktree |
| `git rebase` (stale lane sync) | **Agent** | When the mission branch advanced and the lane must resync |
| `git merge` (lane → mission → target) | Python | `spec-kitty merge` |
| `git push` | Python (opt-in) | `spec-kitty merge --push` only |
| `git push` | **Agent** | Any other push scenario |
| Conflict resolution | **Agent** | During rebase or manual merge |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wildcard/caro/spec-kitty-git-workflow@sha256:631f90114af7e9d1

The line at the top of this page pins the label git:20260427.b2f2f5b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_z2j5ugdk4h3r47hm.svg)](https://markdownregistry.com/a/art_z2j5ugdk4h3r47hm)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Apr 27, 2026.

versioncommittedcommitsizeaudit
git:20260427.b2f2f5b latest2026-04-27 b2f2f5b 8,682 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8682 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wildcard/caro · 40 stars · license AGPL-3.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_z2j5ugdk4h3r47hm
GET https://markdownregistry.com/api/v1/resolve?ref=wildcard/caro/spec-kitty-git-workflow
GET https://markdownregistry.com/api/v1/blob/631f90114af7e9d108a58741af46dcd08163f3a814cbb9d95c905c19d337cc60

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from wildcard/caro

spec-kitty-git-workflow SKILL.md skill
wildcard/caro · .agents/skills/spec-kitty-git-workflow/SKILL.md · Understand how Spec Kitty manages git: what git operations Python handles automatically, what agents must do manually…
git:20260427.b2f2f5b · audit A · 40 stars
spec-kitty-mission-system SKILL.md skill
wildcard/caro · .agents/skills/spec-kitty-mission-system/SKILL.md · Understand how Spec Kitty missions work: the 4 built-in mission types, how they define workflows via step contracts and…
git:20260427.b2f2f5b · audit A · 40 stars
speckit-git-commit SKILL.md skill
wildcard/caro · .agents/skills/speckit-git-commit/SKILL.md · Auto-commit changes after a Spec Kit command completes
git:20260427.b2f2f5b · audit A · 40 stars
speckit-git-feature SKILL.md skill
wildcard/caro · .agents/skills/speckit-git-feature/SKILL.md · Create a feature branch with sequential or timestamp numbering
git:20260427.b2f2f5b · audit A · 40 stars
speckit-git-initialize SKILL.md skill
wildcard/caro · .agents/skills/speckit-git-initialize/SKILL.md · Initialize a Git repository with an initial commit
git:20260427.b2f2f5b · audit A · 40 stars
speckit-git-remote SKILL.md skill
wildcard/caro · .agents/skills/speckit-git-remote/SKILL.md · Detect Git remote URL for GitHub integration
git:20260427.b2f2f5b · audit A · 40 stars
speckit-git-validate SKILL.md skill
wildcard/caro · .agents/skills/speckit-git-validate/SKILL.md · Validate current branch follows feature branch naming conventions
git:20260427.b2f2f5b · audit A · 40 stars
AGENTS.md@.claude AGENTS.md file
wildcard/caro · .claude/AGENTS.md
git:20260124.5839cb3 · audit A · 40 stars
session-discovery SKILL.md skill
wildcard/caro · .claude/plugins/session-wrangler/skills/session-discovery/SKILL.md
git:20260124.b94838f · audit C · 40 stars
ai-marketing-engineering SKILL.md skill
wildcard/caro · .claude/skills/ai-marketing-engineering/SKILL.md · AI-powered marketing engineering skill based on Alon Huri's framework. Transforms marketing from copywriting to…
v1.0.0 · audit A · 40 stars
ai-prompt-engineer SKILL.md skill
wildcard/caro · .claude/skills/ai-prompt-engineer/SKILL.md · AI engineering skill for prompt optimization, context inference, and intelligent command routing across different…
v1.0.0 · audit A · 40 stars
backend-safety-integrator SKILL.md skill
wildcard/caro · .claude/skills/backend-safety-integrator/SKILL.md · Guide for integrating safety validation into new inference backends
git:20260108.c3a4b5c · audit B · 40 stars

Every file in wildcard/caro

Other files named spec-kitty-git-workflow

spec-kitty-git-workflow SKILL.md skill
wildcard/caro · .agents/skills/spec-kitty-git-workflow/SKILL.md · Understand how Spec Kitty manages git: what git operations Python handles automatically, what agents must do manually…
git:20260427.b2f2f5b · audit A · 40 stars

Browse by kind, by grade A, or by owner.