Agent skill

Nvim Commit

by S1M0N38 in S1M0N38/love2d.nvim

Create conventional commits for love2d.nvim that are compatible with release-please and follow SemVer.

MITAuto-check: notesDevelopment

Install Nvim Commit

skills CLI
$ npx skills add S1M0N38/love2d.nvim --skill nvim-commit -a claude-code

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

GitHub CLI
$ gh skill install S1M0N38/love2d.nvim nvim-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/S1M0N38/love2d.nvim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/nvim-commit .claude/skills/nvim-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
nvim-commit
GitHub stars
215
Token cost
~1.5k tokens
SKILL.md length
439 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Create conventional commits for love2d.nvim that are compatible with release-please and follow SemVer.

  • Works in 4 steps: Analyze the diff → Stage files if needed → Determine type, scope, and description → …
  • The user asks to commit changes
  • SKILL.md covers Why this matters, Conventional Commit Format, Commit Types and SemVer Impact and Scopes for love2d.nvim, plus 5 more sections
  • Calls git

What it does

Nvim Commit is an agent skill from S1M0N38/love2d.nvim. Create conventional commits for love2d.nvim that are compatible with release-please and follow SemVer. Use when the user asks to commit changes, make a git commit, or says "/commit" while working on love2d.nvim. Analyzes the diff to produce correctly scoped, typed commit messages that release-please can parse into changelog entries and semantic version bumps.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Commit messages. It works with Lua. The repository describes itself as: ♡ A simple Neovim plugin to build games with LÖVE. The licence is MIT.

When your agent uses it

  • The user asks to commit changes
  • Make a git commit
  • Says /commit while working on love2d.nvim

Example prompts

  • “/commit”
  • “/nvim-commit”

Requirements

  • Pre-approved tools (allowed-tools): Bash

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Analyze the diff
  2. Stage files if needed
  3. Determine type, scope, and description
  4. Execute the commit

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    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

Nvim Commit loads about 1.5k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 439 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:120
    **Never commit**: secrets, `.env`, credentials, private keys.
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

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 S1M0N38/love2d.nvim at commit 2c31946, republished under its MIT licence (© S1M0N38). 439 words, ~1,471 tokens.

Download SKILL.mdSave it as .claude/skills/nvim-commit/SKILL.md (or your agent's skills folder).
name
nvim-commit
description
Create conventional commits for love2d.nvim that are compatible with release-please and follow SemVer. Use when the user asks to commit changes, make a git commit, or says "/commit" while working on love2d.nvim. Analyzes the diff to produce correctly scoped, typed commit messages that release-please can parse into changelog entries and semantic version bumps.
allowed-tools
Bash
license
MIT

love2d.nvim Conventional Commits

Create semantic git commits for love2d.nvim that release-please can parse into changelog sections and correct version bumps.

Why this matters

release-please scans commit messages to decide what goes in the CHANGELOG and whether to bump the patch, minor, or major version. A poorly scoped or mistyped commit either gets ignored or ends up in the wrong changelog section.

Conventional Commit Format

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

[optional body]

[optional footer(s)]

The scope is always present — Neovim plugins benefit from always scoping because modules are small and tightly named.

Commit Types and SemVer Impact

TypePurposeVersion BumpChangelog Section
featNew feature or capabilityminorFeatures
fixBug fixpatchBug Fixes
perfPerformance improvementpatchPerformance
refactorCode restructuring (no behavior)none(omitted)
docsDocumentation onlynone(omitted)
styleFormatting, whitespace (no logic)none(omitted)
testAdd or update testsnone(omitted)
buildBuild system, dependenciesnoneBuild
ciCI configurationnoneCI
choreMaintenance, tooling, metanone(omitted)
revertRevert a previous commitvariesReverts

Scopes for love2d.nvim

The scope identifies the module or area that changed.

Auto-detecting scope from file paths
File Path PatternScope
lua/love2d/init.luainit
lua/love2d/config.luaconfig
lua/love2d/job.luajob
lua/love2d/output.luaoutput
lua/love2d/events.luaevents
lua/love2d/autocmd.luaautocmd
lua/love2d/lsp.lualsp
lua/love2d/health.luahealth
lua/love2d/utils.luautils
lua/love2d/types.luatypes
plugin/love2d.luaplugin
compiler/love.luacompiler
doc/love2d.txtdocs
README.mddocs
tests/*_spec.luaomit scope
after/queries/lua/injections.scminjections
after/syntax/*syntax
libraries/love2d/*library
libraries/luasocket/*library
.github/workflows/*ci
.stylua.toml, .luarc.jsonomit scope

When multiple files span different scopes, pick the scope of the primary change.

Scope style
  • Lowercase, no hyphens or underscores
  • Examples: config, init, plugin, injections, library

Breaking Changes

Signal with ! after the type/scope:

feat(config)!: rename `disabled` to `enabled`

BREAKING CHANGE: `disabled` option renamed to `enabled` with inverted logic.

Workflow

1. Analyze the diff
bash
# Staged changes
git diff --staged

# If nothing staged, check working tree
git diff

# File list for scope detection
git diff --name-only --staged || git diff --name-only
Show full SKILL.md (174 more words)Show less
2. Stage files if needed

If nothing is staged, check git status --porcelain and stage the changed files. Group logically related changes together.

Never commit: secrets, .env, credentials, private keys.

3. Determine type, scope, and description
  • Type: based on the nature of the change
  • Scope: auto-detect from the file paths using the table above
  • Description: one line, present tense, imperative mood, under 72 characters
4. Execute the commit
bash
# Single line
git commit -m "feat(config): add output option for panel configuration"

# With body
git commit -m "$(cat <<'EOF'
feat(config): add makeprg support for LÖVE projects

Automatically configure makeprg and errorformat when a LÖVE
project is detected, allowing :make to run and parse errors.
EOF
)"

Writing good descriptions

  • Present tense, imperative mood: "add option" not "added option"
  • Start with lowercase after colon: feat(config): add debounce helper
  • Be specific: "add output option" beats "add new option"
  • Keep under 72 characters
  • Don't end with a period

What to avoid

  • Don't use chore for actual code changes — it won't appear in the changelog
  • Don't combine multiple unrelated changes in one commit
  • Don't use generic scopes like core or misc
  • Don't reference issue numbers in the subject line

Git Safety

  • Never update git config
  • Never run destructive commands (--force, hard reset) without explicit request
  • Never skip hooks (--no-verify) unless asked
  • Never force push to main/master

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

Files

Just SKILL.md in .agents/skills/nvim-commit of S1M0N38/love2d.nvim.

Open the folder on GitHubat commit 2c31946

Compare with similar skills

Nvim 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.

Nvim Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nvim Commit this skillS1M0N38/love2d.nvim215—~1.5kAutomated safety check: NotesMIT
Contextual Commit Messagesyamadashy/repomix29k1 repos~2.7kAutomated safety check: PassMIT
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
Caveman Commitvishiri/fantasia-archive40913 repos~642Automated safety check: PassGPL-3.0
PR Finalize Reviewmicrosoft/garnet12k—~3.1kAutomated safety check: PassMIT
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 yesterday
    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
  • 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
  • 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.

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

More from S1M0N38/love2d.nvim

  • Nvim Doc

    S1M0N38/love2d.nvim

    Write, update, and improve love2d.nvim help documentation (vimdoc) in doc/love2d.txt.

    215 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check: notes
  • Nvim Help

    S1M0N38/love2d.nvim

    Search and read Neovim's built-in :help documentation to look up API signatures, parameter types, option values, and event specifications from the user's installed runtime.

    215 GitHub stars~681 tokensUpdated 3 mo ago
    Auto-check passed
  • Nvim Test

    S1M0N38/love2d.nvim

    Execute tests and diagnose failures for love2d.nvim. An agent skill from S1M0N38/love2d.nvim.

    215 GitHub stars~770 tokensUpdated 3 mo ago
    Auto-check passed
  • Nvim Plugin

    S1M0N38/love2d.nvim

    Neovim plugin development best practices and patterns for love2d.nvim.

    215 GitHub stars~1k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Categories

Questions about Nvim Commit

What does Nvim Commit do?

Create conventional commits for love2d.nvim that are compatible with release-please and follow SemVer. nvim.nvim that are compatible with release-please and follow SemVer.

When should I use Nvim Commit?

Nvim Commit fits situations like: the user asks to commit changes; make a git commit; says /commit while working on love2d.nvim.

How do I install Nvim Commit in Claude Code?

Run `npx skills add S1M0N38/love2d.nvim --skill nvim-commit -a claude-code`. Or copy the skill folder (.agents/skills/nvim-commit in S1M0N38/love2d.nvim) into .claude/skills/nvim-commit in your project. Claude Code loads it when a task matches its description.

How do I install Nvim Commit in Codex?

Run `npx skills add S1M0N38/love2d.nvim --skill nvim-commit -a codex`. Or copy the skill folder (.agents/skills/nvim-commit in S1M0N38/love2d.nvim) into .agents/skills/nvim-commit in your project. Codex loads it when a task matches its description.

Can I use Nvim 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 S1M0N38/love2d.nvim --skill nvim-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/nvim-commit, .gemini/skills/nvim-commit, .github/skills/nvim-commit and .opencode/skills/nvim-commit in your project.

What does Nvim Commit need to run?

Going by SKILL.md and its folder, Nvim Commit needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Bash.

Does Nvim 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 Nvim Commit safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Nvim Commit use?

Nvim Commit is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nvim Commit use?

About 1.5k tokens (SKILL.md is roughly 5.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 Nvim Commit?

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

Who maintains Nvim Commit?

S1M0N38 (a GitHub user) maintains it in S1M0N38/love2d.nvim, which has 215 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on July 7, 2026.

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