How does the skill decide which Conventional Commit type to use?

The skill uses a priority-based logic: first checking file extensions and paths (e.g., .md files as 'docs', package.json as 'build'), and then falling back to Git status (Added as 'feat', Modified as 'fix').

Can I still push everything in a single commit?

Yes. If you provide a message argument (e.g., /push "feat: add login"), the skill switches to single-commit mode and stages all changes together.

Does this work with files I've already staged manually?

Yes. If files are already staged (cached), the skill will prioritize those files for classification and committing. If nothing is staged, it looks at all modified files in the working directory.

What happens if I'm not on the main branch?

By default, it attempts to push to 'main'. However, you can use the --branch flag to specify any target branch, and the skill will handle the branch switching for you.

Smart Git Push & Multi-Commit

Name: Smart Git Push & Multi-Commit
Author: october-academy

byoctober-academy

0•

Developer Tools

Automates the classification, staging, and multi-commit process of your changes using Conventional Commit standards before pushing to remote.

The Smart Git Push skill streamlines your development workflow by automatically grouping changed files into logical commits based on Conventional Commit types. Instead of manually staging files and writing multiple messages, this skill analyzes file extensions and Git statuses to generate separate, structured commits for features, fixes, documentation, build configurations, and more. It intelligently infers scopes from directory structures, calculates change statistics for commit bodies, and handles the branch switching and pushing process, ensuring a clean and professional repository history with minimal manual effort.

Key Features

01Automated branch management including switching and upstream configuration

02Detailed commit message generation including change statistics in the body

03Automatic file classification into Conventional Commit types (feat, fix, docs, build, etc.)

04Intelligent scope inference based on shared parent directories

050 GitHub stars

06Support for multi-commit splitting or single-message commit modes

Use Cases

01Rapidly pushing updates to feature branches without manual 'git add' and 'git commit' cycles

02Ensuring team-wide adherence to Conventional Commit standards automatically

03Organizing a large set of miscellaneous changes into a clean, readable Git history before a PR

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add october-academy/agent-plugins push

For use in Claude.ai and ChatGPT

Download Skill