git-workflow-commit

Creates GitHub issues, branches, and signed commits following a board-driven git workflow.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill git-workflow-commit-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow-commit
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/git-workflow-commit
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill git-workflow-commit-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose track of work when tasks are created without being added to the project board, branches are duplicated, or commits carry the wrong author. This Skill enforces a disciplined sequence — task creation, board placement, branch naming, column moves, and bot-signed commits — so every edit is traceable from board card to merged PR. ## Core Features & Use Cases - Four-step task creation: Runs npm run task:new to create the issue, embed its number in the title, add it to the board, and place it in the first column, with duplicate detection via issue search. - Branch and column discipline: Creates branches named <KEY>-<number>-<slug> from the epic branch and moves the task column (in-progress, in-review) immediately after each step. - Bot-signed commits: Commits with machine-account author/committer environment variables, conventional type(scope): description subjects, and explicit per-file staging verified with git diff --cached. - Use Case: Before starting a bug fix, ask the assistant to create the task, branch, and first commit — it checks the queue for duplicates, verifies board placement, and signs the commit as the bot account. ## Quick Start Create a task on the board, start a branch for it, and prepare a signed commit for my current changes following the git-workflow-commit pattern.

Frequently Asked Questions about git-workflow-commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub issue and add it to a project board automatically?

Run the tree command `npm run task:new` with the epic, title, labels, and body on stdin. It creates the issue via gh, embeds the number in the title, adds it to the board with `gh project item-add`, and verifies board placement before finishing.

How do I commit as a bot account without changing git config?

Set GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, GIT_COMMITTER_NAME, and GIT_COMMITTER_EMAIL as environment variables on the single git commit command. This avoids rewriting the shared git config that belongs to the repository owner.

Why is my GitHub issue not showing on the project board?

The board is not linked to the repository, so `gh issue create` never adds the card by itself. A separate `gh project item-add` call is required, which is why the creation command performs all four steps together.

What branch naming convention works with a delivery guard?

Use `<KEY>-<task-number>-<slug>` with a lowercase hyphenated slug, branched from the epic branch rather than main. The guard parses the name, checks the task exists and is open on the board, and rejects malformed names before the first commit.

Why does git add with multiple paths sometimes add nothing?

The command aborts entirely if any single path does not exist, leaving earlier paths unstaged. Stage files one by one and verify the index with `git diff --cached --name-only` before committing.