shawn-sandy/commit-agent
kit/plugins/git-agent/skills/commit-agent/SKILL.md
Stages all changes and creates a conventional commit message. Analyzes the diff and writes a descriptive, scope-correct commit. Use when the user asks to commit or save work to git.
$ install --global
skillsauthnpx skillsauth add shawn-sandy/agentics commit-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 14, 2026, 2:14 AM328.7s1 file scanned
SKILL.md
- name:
- commit-agent
- description:
- Stages all changes and creates a conventional commit message. Analyzes the diff and writes a descriptive, scope-correct commit. Use when the user asks to commit or save work to git.
- allowed-tools:
- Bash(git *), ToolSearch, ExitPlanMode
- disable-model-invocation:
- true
- model:
- haiku
Stage all changes and create a conventional commit message. Follow these steps in strict order. STOP immediately after step 4.
When not to use
Does not push or create PRs — use pr-agent for that.
Step 0: Exit Plan Mode
If currently in plan mode, call ExitPlanMode first and silently before any other action — Staging and committing are git mutations and cannot proceed inside plan mode. Skip this step entirely when not in plan mode. ExitPlanMode is a deferred tool — use ToolSearch with select:ExitPlanMode first, then call it silently.
Step 1: Guards
Run git status to check repository state.
- Clean working tree (nothing to commit): output "Nothing to commit — working tree is clean." and STOP.
- Detached HEAD (
git branch --show-currentreturns empty): output "Cannot commit: repository is in detached HEAD state. Checkout a branch first." and STOP.
Step 2: Stage Changes
Run git add -A to stage all changes.
This trusts .gitignore to exclude sensitive or generated files. The user is responsible for .gitignore correctness.
Step 3: Analyze Diff and Write Commit Message
Run git diff --staged to inspect all staged changes.
Write a conventional commit message:
<type>(<scope>): <description>
Rules:
- Total length: ≤ 72 characters
- Types:
feat,fix,docs,refactor,test,chore,perf,style,ci,build - Scope: the most-changed top-level directory (e.g.,
plugins/git-agent→plugins/git-agent) - Omit scope entirely if changes span more than 2 top-level directories
- Description: imperative mood, lowercase, no trailing period
Examples:
feat(plugins/git-agent): add commit-agent and pr-agent skillsfix(plugins/code-review): correct activation trigger wordingchore: update marketplace.json with new plugin entry
Step 4: Commit
Run:
git commit -m "<message>"
Output the commit hash and message on success.
If a pre-commit hook fails: report the hook's output verbatim and STOP. Do not retry. Do not use --no-verify. Do not modify the staged files. Let the user fix the issue.
After a successful commit, output one line:
To undo:
git reset HEAD~1
STOP here. Do not run tests, analyze coverage, check for issues, push, create PRs, or take any further action.
Related Skills
shawn-sandy/merge
development
VerifiedTrustedCommunity
Checks whether the branch's PR is ready and merges it when green. Runs the readiness gate, lint, and an approval prompt. Use when the user asks "merge?" or if a PR is ready to merge.
2SKILL.mdUpdated Jul 22, 2026
shawn-sandy/build
development
VerifiedTrustedCommunity
Implements a plan file that already exists. Walks its steps, ticks the spec, re-renders, and runs the completion gates. Use when asked to implement an existing plan.
2SKILL.mdUpdated Jul 21, 2026
shawn-sandy/agentic-memory-management
development
VerifiedTrustedCommunity
Audits and optimizes CLAUDE.md project memory files. Checks adherence to Claude Code best practices and produces actionable fixes. Use when the user asks to audit, optimize, or diagnose a CLAUDE.md.
2SKILL.mdUpdated Jul 21, 2026
shawn-sandy/artifact-to-post
development
VerifiedTrustedCommunity
Converts an HTML artifact or Markdown file into a draft post for a static site. Scopes CSS to keep interactive blocks alive and escapes prose for MDX. Use when asked to turn an artifact into a post.
2SKILL.mdUpdated Jul 21, 2026