When is the best time to invoke this skill?

You should invoke this skill after you have finished making changes to a port and verified them with a successful build, such as through poudriere.

Why are tab characters used in the trailers?

FreeBSD project guidelines require actual tab characters after the colon in commit trailers for standardized alignment in the project's commit history.

Does it support security updates?

Yes, it includes logic for Security (VuXML) and MFC (Merge From Current) trailers specifically required for security-related updates to the ports tree.

How does it handle different maintainer scenarios?

The skill checks the port's MAINTAINER variable. If you are the maintainer or the reporter, it omits unnecessary approval trailers; otherwise, it prompts for or adds the appropriate 'Approved by' metadata.

Why does this skill use --no-gpg-sign?

It creates the initial commit without a signature so the user can review the content and then use 'git commit --amend -S' to apply their own GPG signature before pushing.

FreeBSD Port Commit Formatter

Name: FreeBSD Port Commit Formatter
Author: lwhsu

bylwhsu

0•

Developer Tools

Automates the creation of standardized FreeBSD ports tree commits with correctly formatted subject lines and metadata trailers.

This skill streamlines the FreeBSD port contribution process by automatically generating Git commit messages that adhere to strict project guidelines. It intelligently identifies the maintainer, selects the appropriate subject line prefix based on the change type (update, fix, or new port), and assembles mandatory metadata trailers like PR numbers, approvals, and security VIDs using the required tab-character formatting. By automating these technicalities, it ensures that contributions are ready for review and reduces common formatting errors that occur during the manual commit process.

Key Features

01Standardized subject line generation for updates, fixes, and new ports

02Precise trailer assembly using mandatory tab character separation

03Automated Git commit execution using HEREDOC to preserve formatting

04Support for security-specific metadata including VuXML VIDs and MFC branches

050 GitHub stars

06Automatic maintainer and authorship detection for correct attribution

Use Cases

01Formatting a bug fix commit with proper PR and maintainer approval trailers

02Submitting a brand new port to the FreeBSD ports tree with correct categories

03Committing a version update to a FreeBSD port after a successful Poudriere build

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lwhsu/freebsd-claude-skills port-commit

For use in Claude.ai and ChatGPT

Key Features

01Standardized subject line generation for updates, fixes, and new ports

02Precise trailer assembly using mandatory tab character separation

03Automated Git commit execution using HEREDOC to preserve formatting

04Support for security-specific metadata including VuXML VIDs and MFC branches

050 GitHub stars

06Automatic maintainer and authorship detection for correct attribution

Use Cases

01Formatting a bug fix commit with proper PR and maintainer approval trailers

02Submitting a brand new port to the FreeBSD ports tree with correct categories

03Committing a version update to a FreeBSD port after a successful Poudriere build

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lwhsu/freebsd-claude-skills port-commit

For use in Claude.ai and ChatGPT