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.