scanning-git-for-tils

Scan GitHub commit history for TIL-worthy commits and generate Markdown summaries.

24|3|Updated Aug 2, 2020
One-click install
npx skills add https://github.com/ooloth/dotfiles --skill scanning-git-for-tils
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scanning-git-for-tils
Source: https://github.com/ooloth/dotfiles/tree/main/tools/claude/config/skills/scanning-git-for-tils
Command: npx skills add https://github.com/ooloth/dotfiles --skill scanning-git-for-tils

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires notion-client, pydantic, op.

What problem does it solve?

Scans GitHub commits to surface TIL-worthy topics, tracks assessed commits in Notion to avoid duplicates, and presents a ranked list for drafting.

Core Features & Use Cases

  • Cross-repo scan: Analyze commits across multiple repositories for educational value.
  • Notion integration: Track assessed commits to prevent duplicate drafting.
  • Output: Markdown-ready summaries with draft angles.

Quick Start

Run the scan script to fetch TIL candidates and generate a markdown summary: python3 ~/.claude/skills/scanning-git-for-tils/scan_git.py 30

Frequently Asked Questions about scanning-git-for-tils

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

FAQPage Schema
How do I scan Git commits across multiple repositories for learning opportunities?

Scanning Git commits identifies non-obvious educational patterns by filtering noise like dependabot updates and merge commits. This Skill analyzes your GitHub history across repos and organizations, surfacing TIL-worthy commits ranked by learning value, then outputs a Markdown summary and candidate list for evaluation.

Can I track which commits I've already assessed to avoid duplicate work?

Yes. This Skill integrates with Notion to persistently track assessed commits, preventing duplicates across scans. Evaluated commits are stored in your Notion workspace, so subsequent runs automatically skip already-reviewed items.

What do I need to run a Git commit scan with this Skill?

You need Python 3.11+, the GitHub CLI (gh), the 1Password CLI (op) for secret retrieval, and Notion API access. The Skill uses inline dependencies and runtime validation, so additional setup beyond these CLIs and API credentials is minimal.

How do I get a Markdown-ready summary from Git commits for drafting?

Run the scan script with a day range (e.g., last 30 days) to fetch TIL candidates. The Skill returns a JSON payload containing a Markdown field with formatted summaries and a new_commits list, ready for Claude or your writing workflow.

Does this work with commits across multiple GitHub organizations?

Yes. The Skill performs cross-repository and cross-organization scanning via the GitHub CLI, automatically aggregating commits from all accessible repos into a single ranked analysis and summary.

What types of commits does the Skill filter out?

The Skill excludes dependabot updates, merge commits, and version bumps to surface only substantive, learning-focused changes. This filtering reduces noise and surfaces commits with genuine educational value.