machina-doc

Generate Markdown accomplishment reports from git commit history.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the generation of accomplishment reports and contribution summaries from git history, reducing manual documentation effort for engineering teams.

Core Features & Use Cases

  • Automated Report Generation: Compile commits across multiple repositories into a single, author-focused accomplishments document.
  • Impact Classification: Analyze commits to categorize impact (Cost, Performance, Architecture, Quality, DevEx, Infrastructure).
  • Timeline & Metrics: Produce a narrative timeline and quantitative statistics (commits, files changed, lines added/deleted) by author and date range.
  • Use Case: An engineering manager wants an end-of-quarter report for a senior developer, summarizing contributions, changed files, and notable fixes.

Quick Start

Use machina-doc to generate an accomplishments report for author "dbeal" for the last quarter across all repos in the workspace. The tool will output docs/ACCOMPLISHMENTS_<AUTHOR>.md with an auditable history.

Frequently Asked Questions about machina-doc

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

FAQPage Schema
How do I generate an accomplishment report from git history across multiple repositories?

To generate an accomplishment report from git history, you can automate the aggregation of commit data across all relevant repositories within your workspace. The tool compiles commits, categorizes impact, and outputs a structured Markdown report.

Can I classify the engineering impact of my git commits automatically?

Yes, you can classify the engineering impact of git commits automatically. The tool analyzes commit history to categorize contributions into predefined impact areas such as Cost, Performance, Architecture, Quality, DevEx, and Infrastructure for comprehensive documentation.

How do I compile contribution summaries and metrics for a specific author and date range?

You can compile contribution summaries for a specific author and date range by analyzing git history across repositories. The process aggregates quantitative statistics including commits, files changed, and lines added or deleted into a narrative timeline.

Does automated git repo analysis work for generating end-of-quarter engineering reports?

Automated git repo analysis works for generating end-of-quarter engineering reports by aggregating commit data across all workspace repositories. It produces a structured Markdown document summarizing contributions, changed files, and notable fixes for the specified timeframe.

What format does the automated contribution report output use?

The automated contribution report output uses Markdown format. It generates a structured file containing an auditable history, narrative timeline, quantitative metrics, and categorized impact classifications for the specified author.