agentleFS
fmindfmind/dotfiles/skills/git-delivery/SKILL.md

git-delivery

Skill13 starsChanged 4 days agoMITView on GitHub

Commit, push, and release with Conventional Commits; branches, worktrees, conflicts, and hook fixes.

3 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Follow requested branch and release modes: if the user requests a branch or PR, follow git-worktree and github-pull-request.

    line 21
  2. Distinctive:

    Commit only the staged selection: never auto-stage unrelated changes.

    line 27

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Git Delivery

Deliver only the authorized changes while preserving the index, branch intent, and enabled hooks. Branching, pushing, and release publication are separate modes of the same workflow.

Workflow

  1. Resolve delivery authority and target branch: take both from the request; inspect the current branch and unmerged work before switching. Never overwrite an existing branch or move unrelated commits. History investigation is read-only: fetch missing objects into an isolated clone and bisect in a disposable worktree; pulling into the working tree or rewriting history needs authority.
  2. Match work to the request: a commit-only request preserves the staged selection and stops after committing. A delivery request includes staging and pushing only its intended changes; neither implies release publication.
  3. Follow requested branch and release modes: if the user requests a branch or PR, follow git-worktree and github-pull-request. A later release instruction selects the release mode; use the repository's native release task where present.
  4. Verify the delivery: the exact commit, remote destination, and requested publication level. Keep published tags immutable and preserve enabled hooks.

Commit messages

  • Write one Conventional Commits subject: <type>(<scope>): <description> with type feat, fix, chore, docs, refactor, test, perf, ci, build, style, or revert; imperative, under 72 characters, ! after the type or scope for a breaking change, and no AI attribution or co-author trailers.
  • Commit only the staged selection: never auto-stage unrelated changes; on a hook failure or an empty index, report it and do not amend.

Task guides

<!-- guides:start -->
  • git-add-commit-push: Stage, commit, push, and recover hook failures within the authorized scope.
  • git-worktree: Create Git branches, worktrees, or isolated snapshots of uncommitted work.
  • release: Prepare, publish when requested, or verify versioned releases.
  • resolve-conflicts: Resolve Git merge or rebase conflicts by both sides' intent; verify the result.
<!-- guides:end -->

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.