flawed-sample-skill

Generate conventional-commit messages from staged git diffs.

30|5|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/bjcoombs/ai-native-toolkit --skill flawed-sample-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flawed-sample-skill
Source: https://github.com/bjcoombs/ai-native-toolkit/tree/main/skills/skill-forge/tests/fixtures/flawed-sample-skill
Command: npx skills add https://github.com/bjcoombs/ai-native-toolkit --skill flawed-sample-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the inconsistency and manual effort required to write standardized commit messages, ensuring your project history remains clean and machine-readable.

Core Features & Use Cases

  • Conventional Formatting: Automatically structures commit messages using the type(scope): subject format.
  • Semantic Context: Analyzes staged git changes to suggest appropriate commit types like feat, fix, or docs.
  • Use Case: When you have finished a set of changes, use this skill to generate a professional, conventional-commit compliant message that links to your work tracker.

Quick Start

Use the flawed-sample-skill to generate a conventional commit message for the currently staged changes in this repository.

Frequently Asked Questions about flawed-sample-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are conventional commit messages and why use them in git?

Conventional commit messages structure git history using a type(scope): subject format, making project history clean and machine-readable for automated semantic versioning. This skill generates these formatted messages based on staged git diffs.

How do I generate a conventional commit message from staged git changes?

To generate a conventional commit message, run this skill against your staged git changes. It analyzes the file modifications and automatically suggests an appropriate commit type, scope, and subject matching the conventional format.

Does this conventional commit generator require git access to read diffs?

Yes, this conventional commit generator requires git access to read staged changes. It interprets file modifications to determine semantic context and suggest appropriate commit types like feat, fix, or docs.

Can I use this tool to automate semantic versioning for software development workflows?

Yes, you can use this tool to automate semantic versioning workflows. It generates standardized conventional-commit messages that ensure clean project history and machine-readable commit types required for automated versioning.

What's the best way to structure commit messages for automated semantic versioning?

The best way to structure commit messages for semantic versioning is using the conventional type(scope): subject format. This skill automatically applies this structure by analyzing staged git diffs and categorizing changes into types like feat or fix.

What are the limitations of automatically generating conventional commit messages from git diffs?

A limitation of automatically generating conventional commit messages from git diffs is that the semantic context is inferred solely from file modifications. Complex or highly coupled changes may require manual review to ensure the suggested commit type is accurate.