here-be-git_skill

Overview

This skill initializes a Git repository in the current directory and optionally sets up agent commit instructions and a .gitignore. It guides the user through confirming automatic commit guidance for agents, creating or updating AGENTS.md and CLAUDE.md as needed, and generating a tailored .gitignore. The goal is a clean, version-controlled workspace with clear agent workflow notes.

How this skill works

The skill runs git init unless a repository already exists, then asks whether to add agent commit instructions. If confirmed, it creates or appends a Git workflow section to AGENTS.md and ensures CLAUDE.md references AGENTS.md at the top. It then offers to generate a .gitignore based on common flavours or user-specified patterns and commits changes with clear, atomic messages.

When to use it

• You want to initialize version control in a project folder
• You want agents to follow a consistent commit workflow
• You need a .gitignore tailored to language or OS patterns
• You are starting a new project and want immediate Git setup
• You want concise, atomic commits documenting initial configuration

Best practices

• Notify the user if git is already initialized and skip redundant init
• Keep agent commit guidance brief and clear to encourage consistent behaviour
• Create or append AGENTS.md atomically with a single clear commit
• Prepend @AGENTS.md at the top of CLAUDE.md only if not already present
• When creating .gitignore, include both common defaults for the chosen flavour and any user-specified patterns

Example use cases

• New project: run the skill to initialize git, add Python .gitignore, and add agent commit rules
• Existing repo without agent rules: skip init, append commit guidance to AGENTS.md and update CLAUDE.md
• Cross-platform repo: generate a combined .gitignore for macOS, IDE files, and Node.js artifacts
• Minimal setup: initialize git and only create AGENTS.md so agents know to commit frequently