dot_claude/skills/git-expert/SKILL.md
Use when performing complex git operations, semantic diffs with `sem`, entity-level merges with `weave`, or GitHub CLI (`gh`) tasks beyond basic commits.
npx skillsauth add nijaru/dotfiles git-expertInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
.git/. If present and .jj/ is absent, use git as the primary interface.sem diff for entity-level changes (functions, classes) and git dft (difftastic) for structural diffing.| Tool | Task | Command | Purpose |
| :--- | :--- | :--- | :--- |
| sem | sem diff | sem diff | Entity-level changes (functions/classes). |
| difftastic | git dft | git dft | Structural diffing that ignores syntax noise. |
| delta | git log -p | git log -p | Colorized diffing for history review. |
weave is configured globally as a merge driver. Most merges use it automatically.weave claim <entity> before editing to prevent merge conflicts. Run weave release <entity> after committing.weave summary to parse structured conflict markers.gh pr create, gh pr checkout, gh pr list.gh repo view, gh repo clone.gh issue list, gh issue view.git-commit skill for message format and rules..git/info/exclude for agent files (ai/, .tasks/) as per git-local-exclude.| Excuse | Reality |
| :--- | :--- |
| "Line diff is fine" | You're missing the structural context. Use sem or dft. |
| "I'll use the git UI" | The gh CLI is faster and more automatable for agents. |
| "I'll use .gitignore" | Use git-local-exclude for files only YOU (the agent) use. |
| "I'll claim later" | If multiple agents are working, weave claim is essential to prevent conflicts. |
development
Use after completing a bug fix, feature, refactor, or tk task when the first implementation taught enough context to replace it with a simpler, cleaner, or more coherent version before finalizing.
development
Use when writing, migrating, or reviewing Zig code across recent stable versions (0.14-0.16), especially to correct stale syntax or stdlib, build.zig, allocator, formatting, or runtime API knowledge.
documentation
Use when reviewing or revising text (prose, docs, commits) to remove AI patterns and improve voice/clarity.
content-media
Use when fetching X/Twitter post content by URL, or searching for recent X posts.