# Git

> Specialized git operations — semantic commits, PR descriptions, branch management, conflict resolution guidance. Replaces ad-hoc git commands with a dedicated, convention-aware utility.

- **Type:** Skill
- **Install:** `agentstack add skill-rune-kit-rune-git`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Rune-kit](https://agentstack.voostack.com/s/rune-kit)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Rune-kit](https://github.com/Rune-kit)
- **Source:** https://github.com/Rune-kit/rune/tree/master/skills/git

## Install

```sh
agentstack add skill-rune-kit-rune-git
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# git

## Purpose

Specialized git operations utility. Handles semantic commits, PR descriptions, branch naming, and changelog generation with consistent conventions. Replaces scattered git logic across cook Phase 7 and other skills with a single, convention-aware utility.

## Triggers

- Called by `cook` Phase 7 for commit creation
- Called by `scaffold` Phase 8 for initial commit
- Called by `team` for parallel branch/PR management
- Called by `docs` for changelog generation
- Called by `launch` for release tagging
- `/rune git commit` — manual semantic commit
- `/rune git pr` — manual PR generation
- `/rune git branch ` — generate branch name
- `/rune git changelog` — generate changelog from commits
- `/rune git release ` — create tagged release with changelog

## Calls (outbound)

None — pure L3 utility. Reads git state, produces git commands/output.

## Called By (inbound)

- `cook` (L1): Phase 7 — create semantic commit after implementation
- `scaffold` (L1): Phase 8 — initial commit with generated project
- `team` (L1): parallel PR management across workstreams
- `launch` (L1): release tagging and changelog
- `docs` (L2): changelog generation sub-workflow
- User: `/rune git` direct invocation

## Modes

### Commit Mode (default)

Analyze staged changes and produce a semantic commit.

### PR Mode

Analyze full branch diff against base and produce a pull request.

### Branch Mode

Generate a branch name from a task description.

### Changelog Mode

Generate changelog entries from commit history.

## Executable Steps

### Commit Mode

#### Step 1 — Analyze Staged Changes

Read `git diff --staged` and `git status`. Classify the change:

| Type | Signal | Prefix |
|------|--------|--------|
| New feature | New files, new exports, new routes | `feat` |
| Bug fix | Changed logic in existing code, test fix | `fix` |
| Refactor | Structural change, no behavior change | `refactor` |
| Test | Only test files changed | `test` |
| Documentation | Only .md, comments, JSDoc changed | `docs` |
| Build/CI | Config files, CI pipelines, Dockerfile | `chore` |
| Performance | Optimization, caching, query improvement | `perf` |

#### Step 2 — Detect Scope

Extract scope from file paths:
- `src/auth/*` → scope: `auth`
- `src/components/Button.tsx` → scope: `ui`
- `api/routes/users.ts` → scope: `api`
- Multiple directories → omit scope or use most relevant
- Root config files → scope: `config`

#### Step 3 — Generate Commit Message

Format: `(): `

Rules:
- Description: imperative mood, lowercase first letter, no period
- Max 72 characters for subject line
- If > 5 files changed → add body with bullet summary
- If breaking change detected (removed export, changed API signature, schema change) → add `!` suffix and `BREAKING CHANGE:` footer

```
feat(auth): add JWT refresh token rotation

- Add refresh token endpoint with sliding window expiry
- Store token family for reuse detection
- Add middleware to validate refresh tokens

BREAKING CHANGE: /api/auth/refresh now requires refresh_token in body instead of cookie
```

#### Step 4 — Execute

Run `git commit` with the generated message. If pre-commit hooks fail → report the failure, do not `--no-verify`.

### PR Mode

#### Step 1 — Analyze Branch

Read ALL commits on the current branch vs base branch using `git log ..HEAD` and `git diff ...HEAD`.

Do NOT just look at the latest commit — PRs include ALL branch commits.

#### Step 2 — Generate PR

```markdown
## Summary

## Changes
- [grouped by feature/area]

## Test Plan
- [ ] [specific test scenarios]

## Breaking Changes
- [if any — list explicitly]
```

Title: ` from current branch.

### Changelog Mode

#### Step 1 — Read History

Read commits since last tag (`git log $(git describe --tags --abbrev=0)..HEAD`) or since specified reference.

#### Step 2 — Group and Format

Group commits by conventional commit type. Format as [Keep a Changelog](https://keepachangelog.com/):

```markdown
## [Unreleased]

### Added
- New feature description (#PR)

### Fixed
- Bug fix description (#PR)

### Changed
- Change description (#PR)

### Removed
- Removed feature (#PR)
```

Link to PRs/issues when references found in commit messages.

### Release Mode

Create a version tag with release artifacts.

**Triggers:**
- `/rune git release ` — create release for specified version
- Called by `launch` (L1) during release pipeline
- Called by `deploy` (L2) after successful production deploy

#### Step 1 — Validate Version

Parse version string. Must follow semver (`major.minor.patch`):
- Breaking changes → major bump
- New features → minor bump
- Bug fixes → patch bump

Check `git tag -l` to ensure version doesn't already exist.

#### Step 2 — Generate Release Artifacts

1. **Changelog**: Run Changelog Mode to generate entries since last tag
2. **Version bump**: Update version in `package.json`, `pyproject.toml`, `Cargo.toml`, or equivalent
3. **Release notes**: Summarize changes for GitHub Release body

#### Step 3 — Tag and Push

```bash
git add 
git commit -m "chore: bump version to v"
git tag -a v -m "Release v"
git push origin master --tags
```

#### Step 4 — Create GitHub Release

```bash
gh release create v --title "v" --notes ""
```

#### Step 5 — Notify

If deploy reports customer email list available (via rune-pay `/admin/emails`), flag for notification.

## Output Format

### Commit Mode
```
(): 

[optional body — bullet summary if > 5 files changed]

[BREAKING CHANGE: description — if breaking change detected]
```

### PR Mode
```
Title: :  (/
```
Examples: `feat/jwt-refresh`, `fix/123-login-crash`, `refactor/auth-module`

### Changelog Mode
```markdown
## [Unreleased]

### Added
- Feature description (#PR)

### Fixed
- Bug fix description (#PR)

### Changed
- Change description (#PR)
```

### Release Mode
```
## Release: v
- **Tag**: v
- **Commits**: [count] since last release
- **Changelog**: [path to CHANGELOG.md]
- **GitHub Release**: [URL]
- **Artifacts**: version bump, changelog, tag, release
```

## Constraints

1. MUST use conventional commit format — no freeform messages
2. MUST analyze full diff before generating message — don't guess from file names alone
3. MUST detect breaking changes — missing BREAKING CHANGE footer causes downstream issues
4. MUST NOT use `--no-verify` — if hooks fail, report and fix
5. MUST NOT force push unless explicitly requested by user
6. PR mode MUST analyze ALL commits on branch, not just the latest
7. MUST respect project's existing commit conventions if detected (check recent git log)

## Sharp Edges

| Failure Mode | Severity | Mitigation |
|---|---|---|
| Commit message doesn't match actual changes | HIGH | Step 1 reads full diff, not just file names |
| PR description covers only last commit | HIGH | Step 1 reads ALL commits on branch |
| Missing breaking change detection | HIGH | Check: removed exports, changed function signatures, schema changes |
| Branch name too long or has special characters | LOW | Max 50 chars, kebab-case only |
| Force push without user consent | CRITICAL | Constraint 5: never force push unless explicitly requested |
| Ignoring project's existing conventions | MEDIUM | Check recent `git log --oneline -10` for existing style |

## Done When

### Commit Mode
- Staged diff analyzed and change type classified
- Scope extracted from file paths
- Semantic commit message generated (subject + body if needed)
- Breaking changes detected and flagged
- Commit executed (or failure reported)

### PR Mode
- All branch commits analyzed (not just latest)
- Summary covers full change set
- Test plan included
- PR created with `gh pr create`

### Branch Mode
- Branch name follows convention
- Branch created from current HEAD

### Changelog Mode
- All commits since last tag grouped by type
- Formatted as Keep a Changelog
- PR/issue references linked

## Cost Profile

~500-2000 tokens input, ~200-800 tokens output. Haiku — git operations are mechanical and convention-based, no deep reasoning needed.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Rune-kit](https://github.com/Rune-kit)
- **Source:** [Rune-kit/rune](https://github.com/Rune-kit/rune)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-rune-kit-rune-git
- Seller: https://agentstack.voostack.com/s/rune-kit
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.