commit

Vantle's avatarfrom Vantle

Create a commit following Vantle's release message standards. Analyzes staged changes and generates a structured commit message with component sections linking to Readme.md files. Use /commit when ready to commit changes.

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026

When & Why to Use This Skill

This Claude skill automates the generation of structured Git commit messages according to Vantle's release standards. By analyzing staged changes and mapping them to specific project components, it ensures consistent, high-quality version control history with integrated documentation links to Readme files.

Use Cases

  • Standardizing Commit History: Automatically enforce a uniform, professional commit message format across a development team to improve repository readability and auditability.
  • Automated Documentation Linking: Seamlessly link specific code changes to their corresponding Readme.md files within the commit message to enhance traceability between code and documentation.
  • Complex Release Management: Summarize multi-component changes into a structured release message, logically grouping updates into sections like Build, Generation, and Observation.
  • Workflow Efficiency: Reduce the manual overhead of analyzing staged changes and manually formatting multi-line commit messages, allowing developers to focus on coding.
namecommit
descriptionCreate a commit following Vantle's release message standards. Analyzes staged changes and generates a structured commit message with component sections linking to Readme.md files. Use /commit when ready to commit changes.
allowed-toolsRead, Glob, Grep, Bash(git status:*), Bash(git diff:*), Bash(git log:*), Bash(git add:*), Bash(git commit:*)

Vantle Commit Standards

Create commits following Vantle's structured release message format.

Message Format

[Vantle] [Release] [Readme.md]: Brief title describing all changes

[Component] [path/to/Readme.md]: Component description:
- Feature or change 1
- Feature or change 2

[Component2] [path/to/Readme.md]: Another component:
- Change 1
- Change 2

Structure Rules

Header Line

  • Format: [Vantle] [Release] [Readme.md]: Title
  • Title should summarize ALL major changes in the commit
  • Keep title concise but descriptive

Component Sections

  • Each major component gets its own section
  • Format: [Name] [path/to/Readme.md]: Description:
  • Link to the component's Readme.md file
  • Use bullet points for specific changes
  • Order sections logically: Build, Generation, then feature-specific components

Standard Component Order

  1. [Build] [MODULE.bazel] - Dependency and toolchain changes
  2. [Generation] [system/generation/Readme.md] - Code generation framework
  3. [Observation] [system/observation/Readme.md] - Telemetry and tracing
  4. [Molten] [Molten/Readme.md] - Molten language and runtime

Commit Process

Step 1: Analyze Changes

git status --porcelain
git diff --cached --stat

Step 2: Identify Components

For each changed area, determine:

  1. Which component it belongs to
  2. The path to that component's Readme.md
  3. A concise description of changes

Step 3: Generate Message

Build the commit message following the format above.

Step 4: Create Commit

git commit -m "$(cat <<'EOF'
[Vantle] [Release] [Readme.md]: Title here

[Component] [path/Readme.md]: Description:
- Change 1
- Change 2
EOF
)"

Example Commit

[Vantle] [Release] [Readme.md]: Observation telemetry with generation refinements

[Build] [MODULE.bazel]: Async and telemetry dependencies:
- tracing, tracing-subscriber, tracing-chrome
- prost, tonic, tokio (gRPC transport)
- dashmap, url

[Generation] [system/generation/Readme.md]: Code generation framework refinements:
- Streamlined module organization
- Improved error diagnostics with miette
- Format string interpolation cleanup

[Observation] [system/observation/Readme.md]: Trace streaming and recording framework:
- Portal server with gRPC transport
- #[trace] macro for function instrumentation
- Channel-based span filtering
- File and network trace sinks

[Molten] [Molten/Readme.md]: Forge observation integration:
- --address flag for trace streaming
- File and gRPC sink support

Guidelines

  1. Never co-author - Do not add co-author lines
  2. Link to Readme - Every component section must reference its Readme.md
  3. Be specific - Bullet points should describe actual changes, not vague statements
  4. Group logically - Related changes go in the same component section
  5. Order consistently - Follow the standard component order