repo-butler

Generate portfolio-wide GitHub health dashboards and remediation proposals.

3|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/IsmaelMartinez/repo-butler --skill repo-butler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-butler
Source: https://github.com/IsmaelMartinez/repo-butler/tree/main/docs
Command: npx skills add https://github.com/IsmaelMartinez/repo-butler --skill repo-butler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Repo Butler eliminates the manual effort of tracking repo health across an entire GitHub portfolio by continuously observing, assessing, and proposing improvements with a cross-repo governance view.

Core Features & Use Cases

  • Cross-repo portfolio health dashboards: Generates per-repo and portfolio HTML dashboards for fast triage of what is good, what is drifting, and what is missing.
  • Seven-phase roadmap and governance loop: Runs a scheduled pipeline that observes repository state, computes trends, rewrites roadmaps, detects governance issues, and then proposes remediation.
  • AI-assisted assessment and proposal generation: Uses LLMs for assessments/ideation while gating all GitHub writes through safety validators.
  • AI-agent interfaces (MCP + discovery card): Exposes read-only tooling so AI agents can query tiers, governance findings, snapshots diffs, and trigger refresh.

Quick Start

Ask the AI agent to run the reporting pipeline for a portfolio by triggering phase "report" for dashboards, or phase "all" to execute the full seven-phase loop.

Frequently Asked Questions about repo-butler

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

FAQPage Schema
How do I generate cross-repo GitHub portfolio health dashboards automatically?

You can generate cross-repo GitHub portfolio health dashboards automatically by triggering the reporting pipeline's "report" phase, which observes repository states and computes trends to produce HTML dashboards. This eliminates manual tracking across your organization's repositories.

What is LLM-assisted remediation for GitHub governance issues?

LLM-assisted remediation for GitHub governance uses AI models to assess repository states and propose fixes, while gating all actual GitHub writes through safety validators. This detects governance issues across a portfolio and generates remediation proposals without uncontrolled automated changes.

How do I run a full governance and roadmap generation loop for my GitHub repositories?

To run a full governance and roadmap generation loop, trigger phase "all" to execute the seven-phase pipeline. This observes repository state, computes trends, rewrites roadmaps, detects governance issues, and proposes remediation with snapshot persistence.

Can AI agents query GitHub portfolio health insights via MCP tools?

Yes, AI agents can query GitHub portfolio health insights via read-only MCP tools. These interfaces allow agents to query tiers, governance findings, snapshot diffs, and trigger refresh operations without requiring direct manual intervention.

Does this portfolio health tool perform direct write operations on my GitHub repositories?

The tool gates all GitHub writes through safety validators before execution. While it uses LLMs for assessments and proposal generation, it applies safety validation for writes to ensure controlled remediation across your organization's portfolio.

What is the best way to continuously monitor repository health across an entire GitHub organization?

The best way to continuously monitor repository health across a GitHub organization is using a scheduled maintenance pipeline that takes repository snapshots, computes health trends, and publishes HTML dashboards. This provides cross-repo governance views and automated triage.