Agent skill

Workflow Smart Commit

by macalbert in macalbert/envilder

Analyze staged changes and create a conventional commit with an auto-generated message.

MITAuto-check passedDevelopment

Install Workflow Smart Commit

skills CLI
$ npx skills add macalbert/envilder --skill workflow-smart-commit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install macalbert/envilder workflow-smart-commit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/macalbert/envilder.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/workflow-smart-commit .claude/skills/workflow-smart-commit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workflow-smart-commit
GitHub stars
138
Token cost
~473 tokens
SKILL.md length
201 words
Files
2
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Analyze staged changes and create a conventional commit with an auto-generated message.

  • Works in 6 steps: Run git diff --cached --stat to see… → Run git diff --cached to read the full… → Analyze the changes: identify the… → …
  • Committing code
  • SKILL.md covers When to Use, Procedure, Commit Message Format and Constraints
  • Calls git

What it does

Workflow Smart Commit is an agent skill from macalbert/envilder. Analyze staged changes and create a conventional commit with an auto-generated message. Use when committing code, staging changes, or generating commit messages.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

It sits in Development, covering Commit messages. The repository describes itself as: One secret mapping for local dev, CI/CD, and runtime. Envilder resolves cloud secrets from your own vaults without SaaS middlemen, duplicated config, or .env drift. The licence is MIT.

When your agent uses it

  • Committing code
  • Staging changes
  • Generating commit messages

Example prompts

  • “/workflow-smart-commit”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Run git diff --cached --stat to see what's staged.
  2. Run git diff --cached to read the full diff.
  3. Analyze the changes: identify the dominant change type and scope.
  4. Generate a conventional commit message following the format, rules, and scope heuristics.
  5. Present the commit message for user approval.
  6. Run git commit -m "" after approval.

What it can do on your machine

Read from SKILL.md and the folder at commit b6a0327. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workflow Smart Commit loads about 473 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 201 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~473

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from macalbert/envilder at commit b6a0327, republished under its MIT licence (© macalbert). 201 words, ~473 tokens.

Download SKILL.mdSave it as .claude/skills/workflow-smart-commit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
workflow-smart-commit
description
Analyze staged changes and create a conventional commit with an auto-generated message. Use when committing code, staging changes, or generating commit messages.
argument-hint
optional scope override or commit type hint

Smart Commit

Analyze staged changes and create a conventional commit message.

When to Use

  • Creating a commit from staged changes
  • Generating a commit message that follows project conventions
  • Verifying commit message format before committing

Procedure

  1. Run git diff --cached --stat to see what's staged.
  2. Run git diff --cached to read the full diff.
  3. Analyze the changes: identify the dominant change type and scope.
  4. Generate a conventional commit message following the format, rules, and scope heuristics.
  5. Present the commit message for user approval.
  6. Run git commit -m "<message>" after approval.

Commit Message Format

txt
<type>(<scope>): <description>

[optional body]
Types
TypeWhen
featNew feature or capability
fixBug fix
refactorCode restructuring without behavior change
testAdding or updating tests
docsDocumentation only
choreBuild, CI, tooling, dependencies
styleFormatting (no logic change)
perfPerformance improvement
Scopes

See reference.md for the full scope table.

Rules
  • Description: imperative mood, lowercase, no period, max 72 chars
  • Body: wrap at 72 chars, explain why not what
  • If changes span multiple scopes, use the most significant one
  • Breaking changes: add ! after scope: feat(cli)!: remove --legacy flag

Constraints

  • Never commit unstaged changes
  • Never use --no-verify
  • If nothing is staged, tell the user to stage changes first

© macalbert, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .github/skills/workflow-smart-commit of macalbert/envilder.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit b6a0327

Compare with similar skills

Workflow Smart Commit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workflow Smart Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflow Smart Commit this skillmacalbert/envilder138—~473Automated safety check: PassMIT
Contextual Commit Messagesyamadashy/repomix29k1 repos~2.7kAutomated safety check: PassMIT
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
PR Finalize Reviewmicrosoft/garnet12k—~3.1kAutomated safety check: PassMIT
Caveman Commitvishiri/fantasia-archive40913 repos~642Automated safety check: PassGPL-3.0
ToolJet Multi-Repo CommitToolJet/ToolJet41k—~1.3kAutomated safety check: PassAGPL-3.0

Similar skills

  • Writes Conventional Commits whose bodies carry action lines recording the intent, decisions and constraints behind a change, not only what changed.

    29k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • PR Finalize Review

    microsoft/garnet

    Official

    Checks that a pull request's title and description match its implementation and reviews the code for Garnet best practices, reporting findings without posting them.

    12k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Caveman Commit

    vishiri/fantasia-archive

    Ultra-compressed commit message generator. An agent skill from vishiri/fantasia-archive.

    409 GitHub starsUsed in 13 repos~642 tokens
    DevelopmentAuto-check passed
  • Commits changes across ToolJet's root repo and its server/ee and frontend/ee submodules, writing messages from the diffs and updating submodule pointers in order.

    41k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    102k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes

More from macalbert/envilder

All 30 skills in this repo
  • Code Review Perspectives

    macalbert/envilder

    Five independent analysis perspectives for code review: correctness, architecture, security, conventions, and complexity.

    138 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Index of Architecture Decision Records (ADRs) for cross-cutting technical decisions.

    138 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Common Git

    macalbert/envilder

    Git commit messages, PR workflow, and branching strategy using Conventional Commits and Semantic Versioning.

    138 GitHub stars~991 tokensUpdated 2 days ago
    Auto-check passed
  • Common Testing Conventions

    macalbert/envilder

    Mandatory testing conventions including the narrow diagnostic exception for testing test-only code, AAA pattern, test naming, and assertions across all stacks (.NET, TypeScript, Python).

    138 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed
  • Doc Maintenance

    macalbert/envilder

    Workflow for maintaining changelogs, READMEs, and documentation files.

    138 GitHub stars~904 tokensUpdated 2 days ago
    Auto-check passed
  • Doc Sync

    macalbert/envilder

    Audit and synchronize documentation across website, READMEs, and docs/.

    138 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Workflow Smart Commit

What does Workflow Smart Commit do?

Analyze staged changes and create a conventional commit with an auto-generated message. Workflow Smart Commit is an agent skill from macalbert/envilder. Analyze staged changes and create a conventional commit with an auto-generated message.

When should I use Workflow Smart Commit?

Workflow Smart Commit fits situations like: committing code; staging changes; generating commit messages.

How do I install Workflow Smart Commit in Claude Code?

Run `npx skills add macalbert/envilder --skill workflow-smart-commit -a claude-code`. Or copy the skill folder (.github/skills/workflow-smart-commit in macalbert/envilder) into .claude/skills/workflow-smart-commit in your project. Claude Code loads it when a task matches its description.

How do I install Workflow Smart Commit in Codex?

Run `npx skills add macalbert/envilder --skill workflow-smart-commit -a codex`. Or copy the skill folder (.github/skills/workflow-smart-commit in macalbert/envilder) into .agents/skills/workflow-smart-commit in your project. Codex loads it when a task matches its description.

Can I use Workflow Smart Commit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add macalbert/envilder --skill workflow-smart-commit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workflow-smart-commit, .gemini/skills/workflow-smart-commit, .github/skills/workflow-smart-commit and .opencode/skills/workflow-smart-commit in your project.

What does Workflow Smart Commit need to run?

Going by SKILL.md and its folder, Workflow Smart Commit needs the command-line tools its instructions call (git).

Does Workflow Smart Commit access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Workflow Smart Commit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workflow Smart Commit use?

Workflow Smart Commit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workflow Smart Commit use?

About 473 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Workflow Smart Commit?

Skills that share tags, products or a category with Workflow Smart Commit: Contextual Commit Messages (yamadashy/repomix, 29k stars), React Router Release Notes Prep (remix-run/react-router, 57k stars), PR Finalize Review (microsoft/garnet, 12k stars) and Caveman Commit (vishiri/fantasia-archive, 409 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workflow Smart Commit?

macalbert (a GitHub user) maintains it in macalbert/envilder, which has 138 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 5, 2026.

Source: macalbert/envilder on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.