Regitize

Portable AI-agent skills for auditing and improving Git history

Install

npx -y skills add gadost/regitize --skill regitize

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

27 days oldThe repository was created 27 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Inspect a Git branch commit-by-commit, derive accurate commit messages from each actual diff, preview the complete old-to-new mapping, and safely rewrite the branch history after explicit approval. Use when the user invokes regitize, asks to repair vague or misleading commit messages, clean up commit-message history, or rename historical commits based on their contents.

SKILL.md

3.4 KB, as published. Nobody here has run it

Regitize Commit Messages

Rewrite commit messages without changing committed file trees or merge topology. Never push rewritten history.

Workflow

Locate this skill directory so its bundled scripts can be executed by absolute path.
Verify the repository and target branch. Default to the current local branch. Refuse a detached HEAD unless the user names a local branch.
Inspect context with git status --short, git branch --show-current, and git log --graph --decorate --oneline --all.
Run node <skill-dir>/scripts/collect-history.mjs --output <repo-git-dir>/regitize/history.json. Read the entire generated history, including every patch. For an unusually large history, process it in batches but do not skip commits.
Derive one proposed message per commit:
- Use an imperative subject, normally no more than 72 characters.
- Describe the behavioral or architectural outcome, not file operations.
- Add a body only for important rationale, constraints, migrations, or secondary effects supported by the diff.
- For merge commits, describe what was integrated; use parent context because the merge diff may be empty.
- Do not invent intent, issue numbers, or impact absent from the repository evidence.
- Preserve a message that is already the most accurate concise description.
Write a plan matching references/plan-format.md to <repo-git-dir>/regitize/message-plan.json.
Run node <skill-dir>/scripts/rewrite-history.mjs --plan <plan-path> without --apply. Fix every validation error.
Show the user the branch, commit count, signed-commit warning if any, and a complete table of old short SHA, old subject, and proposed subject. Explain that all descendant SHAs will change.
Stop and obtain explicit approval for the displayed plan. Approval of an earlier or partial plan does not count.
After approval only, run the same command with --apply. If signed commits exist, also set acknowledgeSignatureLoss: true in the plan only after the user explicitly accepts signature loss.
Verify the new log and report the old head, new head, and backup ref printed by the script. Do not force-push unless the user separately asks for it.

Safety rules

Rewrite one local branch per invocation. Other branches and tags remain at their existing SHAs.
Do not combine this task with squashing, reordering, content edits, author changes, or date changes.
Do not bypass expectedHead; regenerate the plan if the branch moved.
Treat published/shared history as high risk. Recommend coordinating with collaborators before any push.
The helper preserves snapshots and parent topology, creates a backup ref, and refuses unsupported commit metadata unless explicitly acknowledged.

Resources

scripts/collect-history.mjs captures commit metadata, stats, and full textual patches.
scripts/rewrite-history.mjs validates and applies an approved plan using Git plumbing.
references/plan-format.md defines the plan schema and recovery commands.