machina-git

Govern git operations across machina-meta repositories with safety scans.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/NumberOne-AI/machina-meta --skill machina-git
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: machina-git
Source: https://github.com/NumberOne-AI/machina-meta/tree/main/.claude/skills/machina-git
Command: npx skills add https://github.com/NumberOne-AI/machina-meta --skill machina-git

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces a safe, consistent git workflow across the machina-meta workspace, including multiple submodules, guaranteeing atomic commits and reducing human error.

Core Features & Use Cases

  • Mandatory skill gate: All git operations must pass through machina-git, ensuring centralized governance.
  • Working directory safety: Commands must be executed in the correct repository directory within a single shell invocation.
  • Security and readiness checks: Staged changes are scanned for secrets and evaluated for commit readiness before committing.
  • Multi-repo consistency: Manages status, diff, add, commit, push, pull, and submodule operations across all repositories in the workspace.
  • Auditable workflow: Requires explicit user confirmation for destructive actions and pushes.

Quick Start

Before performing any git operation, invoke the machina-git skill. Always cd into the target repository and run commands in a single shell invocation using logical chaining (e.g., cd repos/dem2 && git status). Review staged changes with git diff --cached and only push after explicit confirmation from the user.

Frequently Asked Questions about machina-git

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

FAQPage Schema
How do I ensure safe git commits across multiple repositories and submodules?

To ensure safe git commits across multiple repositories and submodules, use a centralized workflow gate that scans staged changes for secrets and evaluates commit readiness before allowing any git operation. This enforces atomic commits and reduces human error.

How does secret scanning work before pushing git changes?

Secret scanning works by evaluating staged changes for commit readiness before executing a git commit. The workflow requires mandatory invocation before any git command, scanning the working directory for secrets and enforcing explicit user confirmation for destructive actions and pushes.

Can I use conventional commits with a multi-repo git workflow?

Yes, you can use conventional commits with a multi-repo git workflow. The workflow enforces conventional commit usage across all repositories and submodules, requiring you to cd into the target repository and run commands in a single shell invocation using logical chaining.

What is the best way to manage git submodules in a multi-repo workspace?

The best way to manage git submodules in a multi-repo workspace is to use a locked-down workflow that governs submodule updates alongside status, diff, add, commit, push, pull, branch, and tag operations, ensuring working directory safety and multi-repo consistency.

Why does my git workflow require explicit confirmation before pushing?

Your git workflow requires explicit confirmation before pushing to maintain an auditable workflow and prevent destructive actions. This centralized governance ensures all staged changes pass security and readiness checks, reducing human error across multiple repositories.

Do I need to cd into the target directory before running git commands?

Yes, you need to cd into the target repository directory before running git commands. The workflow enforces working directory safety by requiring commands to be executed in the correct repository within a single shell invocation using logical chaining, such as cd repos/dem2 && git status.