commit-push

Enforces Conventional Commits format, branch naming rules, and pre-commit checks for Git workflows.

3|1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/nghyane/VSTEP --skill commit-push-nghyane
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: commit-push
Source: https://github.com/nghyane/VSTEP/tree/main/apps/mobile-v2/.agents/skills/commit-push
Command: npx skills add https://github.com/nghyane/VSTEP --skill commit-push-nghyane

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Inconsistent commit messages, vague change descriptions, and unsafe Git operations make repository history hard to audit and risky to maintain. This Skill standardizes how commits are written, branches are named, and code is pushed so every change is traceable and reviewable. ## Core Features & Use Cases - Conventional Commits enforcement: Requires typed subjects (feat, fix, refactor, etc.) in English, lowercase, imperative mood, under 72 characters, with a mandatory body listing every changed file. - Branch and push workflow rules: Defines branch naming (type/short-description), protected branches (main, mobile), merge-only pulls (no rebase), and no force-push policies. - Pre-commit checklist: Requires typecheck and lint to pass, no console.log or any types, and exclusion of handoff/session files from commits. - Use Case: Before committing a new audio player feature in a React Native app, the Skill produces a compliant message like "feat: add custom audio player" with a full body listing created and modified files, then guides staging only task-related files and pushing the feature branch. ## Quick Start Before committing, ask the assistant to write a compliant commit message and verify the pre-commit checklist for the current changes.

Frequently Asked Questions about commit-push

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

FAQPage Schema
How do I write a Conventional Commits message?▼

Use the format type: subject, where type is feat, fix, docs, refactor, or similar, followed by a lowercase imperative subject under 72 characters. The body must list every changed file grouped by created, modified, or deleted, using imperative verbs like add, update, or remove.

What should a commit message body include?▼

The body must list all changes made, one line per changed file, grouped by files created, modified, and deleted. Exclude handoff or session files like HANDOFF.md since they are not code changes.

How should Git branches be named for features and fixes?▼

Use the pattern type/short-description, such as feat/listening-practice or fix/audio-playback-ios. Create branches from main or mobile, push the branch, and merge into mobile before promoting to main.

Can I use git rebase or force-push on shared branches?▼

No. Pulls must use git pull --no-rebase to merge instead of rebase, and force-push is never allowed on shared branches like main or mobile. Rebase is only permitted when explicitly requested.

What checks must pass before committing code?▼

Run bun run typecheck and bun run lint and ensure both pass. Also verify there are no console.log statements, no any types, no commented-out code, and that only task-related files are staged.