wox-commit

Generate a conventional commit message from the current Wox working tree diff.

27.3k|2.4k|Updated Dec 19, 2013
One-click install
npx skills add https://github.com/Wox-launcher/Wox --skill wox-commit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wox-commit
Source: https://github.com/Wox-launcher/Wox/tree/main/.agents/skills/wox-commit
Command: npx skills add https://github.com/Wox-launcher/Wox --skill wox-commit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing consistent, well-scoped commit messages that cover every change in a working tree is tedious and error-prone, especially when a diff spans multiple unrelated behaviors. This Skill inspects the current Wox repository state and produces a copy-ready commit message without modifying the repository.

Core Features & Use Cases

  • Diff-driven message generation: Reads git status, staged and unstaged diffs, and untracked files to infer every distinct behavior change.
  • Repository-style conventions: Follows the type(scope): imperative summary format and matches the wording of nearby commits, omitting misleading narrow scopes when changes span unrelated areas.
  • Subject plus body output: Always returns one fenced block with a subject and an explanatory body covering each distinct change.
  • Use Case: After finishing a refactor and a bug fix in the Wox launcher, invoke the Skill to receive a single commit message naming both changes, ready to paste into git commit.

Quick Start

Ask the assistant to use $wox-commit to review your current Wox changes and write a commit message for them.

Frequently Asked Questions about wox-commit

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

FAQPage Schema
How do I generate a commit message from my current git diff?

Invoke the Skill with $wox-commit and it inspects git status, staged and unstaged diffs, and untracked files to infer every behavior change. It returns one fenced block containing a subject line and body you can paste directly into a commit.

What commit message format does this Skill follow?

It uses the conventional `type(scope): imperative summary` format with types like feat, fix, refactor, docs, test, build, and chore. The scope is chosen from the narrowest accurate scope already used by nearby commits in the repository.

Does the Skill commit or stage my changes automatically?

No. The Skill only reads the working tree and generates a message. It never stages, commits, amends, pushes, or otherwise modifies the repository, and it does not run tests or hooks.

Can it handle a diff with multiple unrelated changes?

Yes. It names each distinct behavior in the message, putting the dominant change in the subject and the others in the body, or naming peer features together. It avoids picking a misleading narrow scope when changes span unrelated areas.

What happens if my working tree has no changes?

The Skill still returns the standard fenced message block format, then adds a brief note after the block indicating that the diff is empty. It does not fabricate a message for nonexistent changes.