Git Log Intelligence

Prerequisites

• gh CLI installed. Authenticate via one of:
  • GITHUB_PERSONAL_ACCESS_TOKEN environment variable (required)
• For read-only public repo access, grant only the public_repo scope. For private repos, use repo scope.
• Note: this skill creates .config/git_filters.json relative to the script's location to persist ignore patterns. Delete this file to reset to defaults.

Compatibility

• Required tools: gh
• Environment variables:
  • GITHUB_PERSONAL_ACCESS_TOKEN (required): GitHub Personal Access Token. Grant minimal scopes: public_repo for public repos, repo for private repos.

Directory Structure

• git_log_intelligence.py: The primary script containing execution logic.
• .config/git_filters.json: The persistent memory of ignore patterns.

Capabilities

1. Summarize Repo Changes

Fetches the last N days of commits and filters them against the "Ignore List." Command: python3 skills/git_log_intelligence.py summarize OWNER/REPO DAYS

Agent Logic:

Call the script with the repo name and timeframe. Receive a filtered list of "Important" commits. Present a natural language summary to the user, noting how many noisy commits were hidden.

2. Maintaining and Updating the Ignore List

The agent can add new patterns to the ignore list based on user feedback. Command: python3 skills/git_log_intelligence.py ignore "PATTERN"

The agent can also show the current ignore patterns or remove specific ones. Command: python3 skills/git_log_intelligence.py show

The agent can remove a pattern with: Command: python3 skills/git_log_intelligence.py remove "PATTERN"

Usage Example:

1. User: "Claw, stop showing me commits from 'GitHub Actions' or anything starting with 'ci:'."

2. Agent: Runs python3 skills/git_log_intelligence.py ignore "GitHub Actions" and python3 skills/git_log_intelligence.py ignore "^ci:".

3. User: "Show me the current ignore patterns."

4. Agent: Runs python3 skills/git_log_intelligence.py show

5. User: "Remove the ignore pattern for 'GitHub Actions'."

6. Agent: Runs python3 skills/git_log_intelligence.py remove "GitHub Actions"

Technical implementation:

See the git_log_intelligence.py script for the full code, but the key functions are:

1. Quick Scan (Default): python3 skills/git_log_intelligence.py summarize OWNER/REPO DAYS

2. Deep Context (Full Messages): python3 skills/git_log_intelligence.py summarize OWNER/REPO DAYS --full

Note to Agent:

Use --full when the user asks for a "detailed summary," "technical breakdown," or "why" things were changed. Use the default mode for a "quick list" or "recent activity check." You can also ask the user if they want the full context after showing the quick summary.

How It Works

The script uses gh api to fetch commits via the GitHub REST API (/repos/{owner}/{repo}/commits), filters them client-side against .config/git_filters.json, and outputs structured text for the agent to summarize.

Troubleshooting

If the script exits non-zero, check gh auth status first.

User Interaction Flow

1. Request: "What's new in tailscale/tailscale this week?"
2. Execution: Agent runs python3 skills/git_log_intelligence.py summarize tailscale/tailscale 7.
3. Feedback: "Too much noise from the build bot."
4. Learning: Agent runs python3 skills/git_log_intelligence.py ignore "build bot".
5. Next Time: The build bot commits are gone forever.