Here Be Git
Initialise a git repository with optional configuration for agent workflows.
Workflow
Step 1: Initialise Git Repository
Run git init in the current working directory. Confirm to the user that the repository has been initialised.
Step 2: Agent Commit Instructions
Ask the user:
Would you like me to add instructions for the agent to always commit when it's done with a task?
If the user confirms:
- Check if
AGENTS.md exists in the current directory
- If it exists, append the commit instructions to it
- If it doesn't exist, create it with the commit instructions
The commit instructions to add:
## Git Workflow — CRITICAL, MANDATORY, NO EXCEPTIONS
> **THIS IS NOT OPTIONAL.** Every agent operating in this repository MUST follow this workflow after every change, no matter how small. There are ZERO exceptions to this rule. Skipping a commit is never acceptable. If you have made any change to any file, you MUST commit before moving on.
### Rules
1. **ALWAYS commit your changes immediately after completing a task or reaching any logical stopping point.** Do not defer. Do not batch. Do not skip.
2. **ALWAYS commit before ending your session.** The working directory MUST be clean (all changes committed) when you finish. Leaving uncommitted changes is a failure state.
3. **Use clear, descriptive commit messages** that explain what was done and why.
4. **If in doubt, commit.** It is always better to have one commit too many than one too few.
### To be absolutely clear
- "I'll commit later" — **No. Commit now.**
- "It's just a small change" — **Commit it.**
- "I'm about to make another change" — **Commit the current one first.**
- "The user didn't ask me to commit" — **Irrelevant. Commit anyway.**
After creating or updating AGENTS.md, commit it with an appropriate message.
Step 3: Gitignore Configuration
Ask the user:
Would you like me to create a .gitignore? If so, what flavour or patterns should I include? (e.g., Node.js, Python, macOS, IDE files, or specific files/patterns)
If the user provides a flavour or patterns:
- Generate an appropriate
.gitignore based on their input
- For common flavours, include standard patterns:
- Node.js:
node_modules/, dist/, .env, *.log, etc.
- Python:
__pycache__/, *.pyc, .venv/, venv/, .env, *.egg-info/, etc.
- macOS:
.DS_Store, .AppleDouble, .LSOverride, ._*
- IDE files:
.idea/, .vscode/, *.swp, *.swo, *.sublime-*
- Include any specific files or patterns the user mentions
- Commit the
.gitignore with an appropriate message
If the user declines, skip this step.
Notes
- If git is already initialised in the directory, inform the user and skip to Step 2
- Use the AskUserQuestion tool for the confirmation prompts
- Keep commits atomic and well-described
1---2name: here-be-git3description: Initialise a git repository with optional agent commit instructions and .gitignore. Use when users say "here be git", "init git", "initialise git", or otherwise indicate they want to set up version control in the current directory.4metadata:5 source: https://skillmd.com/skills/intellectronica/here-be-git6---78# Here Be Git910Initialise a git repository with optional configuration for agent workflows.1112## Workflow1314### Step 1: Initialise Git Repository1516Run `git init` in the current working directory. Confirm to the user that the repository has been initialised.1718### Step 2: Agent Commit Instructions1920Ask the user:2122> Would you like me to add instructions for the agent to always commit when it's done with a task?2324If the user confirms:25261. Check if `AGENTS.md` exists in the current directory272. If it exists, append the commit instructions to it283. If it doesn't exist, create it with the commit instructions2930The commit instructions to add:3132```markdown33## Git Workflow — CRITICAL, MANDATORY, NO EXCEPTIONS3435> **THIS IS NOT OPTIONAL.** Every agent operating in this repository MUST follow this workflow after every change, no matter how small. There are ZERO exceptions to this rule. Skipping a commit is never acceptable. If you have made any change to any file, you MUST commit before moving on.3637### Rules38391. **ALWAYS commit your changes immediately after completing a task or reaching any logical stopping point.** Do not defer. Do not batch. Do not skip.402. **ALWAYS commit before ending your session.** The working directory MUST be clean (all changes committed) when you finish. Leaving uncommitted changes is a failure state.413. **Use clear, descriptive commit messages** that explain what was done and why.424. **If in doubt, commit.** It is always better to have one commit too many than one too few.4344### To be absolutely clear4546- "I'll commit later" — **No. Commit now.**47- "It's just a small change" — **Commit it.**48- "I'm about to make another change" — **Commit the current one first.**49- "The user didn't ask me to commit" — **Irrelevant. Commit anyway.**50```5152After creating or updating `AGENTS.md`, commit it with an appropriate message.5354### Step 3: Gitignore Configuration5556Ask the user:5758> Would you like me to create a .gitignore? If so, what flavour or patterns should I include? (e.g., Node.js, Python, macOS, IDE files, or specific files/patterns)5960If the user provides a flavour or patterns:61621. Generate an appropriate `.gitignore` based on their input632. For common flavours, include standard patterns:64 - **Node.js**: `node_modules/`, `dist/`, `.env`, `*.log`, etc.65 - **Python**: `__pycache__/`, `*.pyc`, `.venv/`, `venv/`, `.env`, `*.egg-info/`, etc.66 - **macOS**: `.DS_Store`, `.AppleDouble`, `.LSOverride`, `._*`67 - **IDE files**: `.idea/`, `.vscode/`, `*.swp`, `*.swo`, `*.sublime-*`683. Include any specific files or patterns the user mentions694. Commit the `.gitignore` with an appropriate message7071If the user declines, skip this step.7273## Notes7475- If git is already initialised in the directory, inform the user and skip to Step 276- Use the AskUserQuestion tool for the confirmation prompts77- Keep commits atomic and well-described78