Skip to main content

commit: stage, commit, and push changes

Stages and commits changes with a Conventional Commits message based on the diff, then pushes unless --no-push is set.

Source facts

Repository
adventurewave-labs/apsl-core
Last source activity
July 7, 2026 at 01:28
Detected SKILL.md language
English
Stars
0
Forks
0

Uses

Use when changes are ready to commit. There is no target argument. The declared consumed input is diff. You can provide --msg to replace the generated message or --type feat|fix|chore|docs|refactor|test|perf|style to select its type.

Prerequisites

Requires a Git repository and a host that permits Bash(git *). Pushing requires usable remote access. --no-push defaults to false, so choose it if the operation must stay local. Install via the HEAD README command npx skills add adventurewave-labs/apsl-core, or copy the relevant skills into your host skill directory. This is a documented install route, not a command tested here. Invocation uses host slash commands or description-triggered natural language, not a new APSL syntax. The optional apsl-lint CLI needs Node >=18; it is not required to execute these prose instructions and its warnings do not enforce agent behavior.

How to use

Provide your prepared changes and any --msg, --type, or --no-push options through the host invocation. The workflow checks git status and the staged diff. If nothing is staged, it runs git add -A. It derives a Conventional Commits message from the actual staged diff, shows the proposed commit, commits, and pushes unless disabled.

Limitations

This changes the Git index and creates a commit. If nothing was staged, git add -A can include all changes rather than a selected file. With already staged files, the workflow does not say it stages the rest. The generated message has a first line under 72 characters and a body for complex changes. Push is the default and transfers committed content to the configured remote; the source does not define remote visibility, credential setup, or a separate approval step. Showing the proposal is not a technical approval gate. Output is non-pipeable status. The source does not specify how the host retains diff content or credentials. Review staged material and the remote before invoking it. These are agent instructions and advisory I/O declarations, not an executable runtime or enforced contracts. Actual actions depend on the host tools and permissions; they were not run here. MIT, copyright 2026 Marcus Patman: retain the copyright and permission notice; no warranty. This draft pins HEAD. Its ten Skill files equal v0.3.0; only the README install source and added banner/landing docs differ from that tag.

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
namecommit
descriptionStage and commit changes with a well-formed Conventional Commits message. Analyzes the diff to auto-generate a message if none is provided. Supports --msg "custom message", --no-push, --type feat|fix|chore|docs|refactor.