yaacov/git-commit
.cursor/skills/git-commit/SKILL.md
Enforces Conventional Commits format with type prefixes, scopes, and Signed-off-by for kubectl-mtv. Use when committing changes, creating commits, or writing commit messages.
$ install --global
skillsauthnpx skillsauth add yaacov/kubectl-mtv git-commitInstall 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: Apr 17, 2026, 10:22 AM6.2s1 file scanned
SKILL.md
- name:
- git-commit
- description:
- Enforces Conventional Commits format with type prefixes, scopes, and Signed-off-by for kubectl-mtv. Use when committing changes, creating commits, or writing commit messages.
Git Commit Convention
All commits must follow the Conventional Commits format with a DCO sign-off.
Format
<type>(<scope>): <short description>
<body - explain WHY, not WHAT>
Signed-off-by: Name <email>
Commit Command
Always sign off with -s and include a body:
git commit -s -m "$(cat <<'EOF'
fix(mcp): handle nil response from inventory API
Prevents panic when provider inventory returns empty body.
EOF
)"
Type Prefixes
| Type | When to use |
|------|-------------|
| feat | New feature or capability |
| fix | Bug fix |
| refactor | Code restructuring, no behavior change |
| docs | Documentation only |
| test | Adding or updating tests |
| ci | CI/CD changes (workflows, Makefile targets) |
| build | Build system, dependencies, container images |
| chore | Maintenance (deps update, cleanup) |
| perf | Performance improvement |
| style | Formatting, linting (no logic change) |
Scope (Optional)
Area of the codebase in parentheses after the type:
| Scope | Area |
|-------|------|
| cli | CLI commands (cmd/, pkg/cmd/) |
| mcp | MCP server and tools (pkg/mcp/, cmd/mcpserver/) |
| inventory | Inventory API and provider client |
| guide | Technical guide (guide/) |
| deploy | Deployment manifests (deploy/) |
| tui | Terminal UI (pkg/util/tui/) |
| e2e | End-to-end tests (e2e/) |
Omit scope for cross-cutting changes.
Title Rules
- Imperative mood: "add", "fix", "update" (not "added", "fixes", "updates")
- Lowercase after the colon
- Max ~72 characters
- No trailing period
Body
Required. Explain why the change was made, not what changed (the diff shows that). Separate from the title with a blank line. Even for small changes, provide a brief rationale.
Signed-off-by
Every commit must include Signed-off-by: Name <email> (DCO sign-off). Use git commit -s to add it automatically.
AI Co-authorship
When an AI agent contributes to a commit, ask the user whether to add a co-authorship trailer before committing. There are two levels:
- Full co-authorship -- the AI agent helped write production code (features, fixes, refactoring, etc.):
Co-authored-by: AI Agent <[email protected]>
- Unit-test co-authorship -- the AI agent only generated or helped write unit tests:
Co-authored-by: AI Agent (unit tests) <[email protected]>
Place the Co-authored-by line after the Signed-off-by line. If the user declines, omit it entirely.
Examples
feat(cli): add describe hook command
Allow users to inspect hook details including playbook
content and execution phase.
Signed-off-by: Yaacov Zamir <[email protected]>
fix(mcp): handle nil response from inventory API
Prevents panic when provider inventory returns empty body.
Signed-off-by: Yaacov Zamir <[email protected]>
Co-authored-by: AI Agent <[email protected]>
docs(guide): add chapter on warm migration workflow
Covers warm migration lifecycle, cutover timing, and
snapshot scheduling for vSphere providers.
Signed-off-by: Yaacov Zamir <[email protected]>
refactor(tui): extract table rendering into reusable component
Reduces duplication across get commands and makes it
easier to add new table-based views.
Co-authored-by: AI Agent <[email protected]>
Signed-off-by: Yaacov Zamir <[email protected]>
test(cli): add unit tests for describe hook command
Covers edge cases for missing hooks, empty playbooks,
and invalid hook phases.
Co-authored-by: AI Agent (unit tests) <[email protected]>
Signed-off-by: Yaacov Zamir <[email protected]>
build: update forklift dependency to latest v1beta1
Picks up new DynamicProvider CRD types needed for
custom provider support.
Signed-off-by: Yaacov Zamir <[email protected]>
Breaking Changes
Add ! after type/scope and include BREAKING CHANGE: in the body:
feat(mcp)!: rename mtv_query tool to mtv_read
BREAKING CHANGE: mtv_query has been renamed to mtv_read.
Update all MCP client configurations.
Signed-off-by: Yaacov Zamir <[email protected]>
Related Skills
yaacov/update-forklift-version
development
VerifiedTrustedCommunity
Step-by-step guide for updating the kubev2v/forklift Go dependency in kubectl-mtv. Use when bumping the forklift version, syncing settings or CRD types, or checking for upstream changes.
12SKILL.mdUpdated Apr 17, 2026
yaacov/release-workflow
tools
VerifiedTrustedCommunity
Reference for building, releasing, publishing images, and deploying kubectl-mtv. Use when creating releases, building binaries or container images, deploying to OpenShift, or updating the Krew plugin index.
12SKILL.mdUpdated Apr 17, 2026
yaacov/project-testing
tools
VerifiedTrustedCommunity
Guide for writing and running tests in kubectl-mtv, including Go unit tests, MCP e2e tests (Python/pytest), and linting. Use when adding tests, running the test suite, or debugging test failures.
12SKILL.mdUpdated Apr 17, 2026
yaacov/mcp-tool-development
tools
VerifiedTrustedCommunity
Guide for adding or modifying MCP tools and understanding command discovery in kubectl-mtv. Use when working on the MCP server, adding new tools, or changing how commands are exposed to AI assistants.
12SKILL.mdUpdated Apr 17, 2026