mine-logs

Analyze Claude Code session logs and file Facto improvement observations.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/carllelandtaylor/facto --skill mine-logs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mine-logs
Source: https://github.com/carllelandtaylor/facto/tree/main/plugins/facto-dev/skills/mine-logs
Command: npx skills add https://github.com/carllelandtaylor/facto --skill mine-logs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, facto, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of scanning Claude Code session logs to identify events worth noting as Facto improvement observations, reducing the need for manual analysis and improving efficiency.

Core Features & Use Cases

  • Session Log Analysis: Automatically scan session logs for events relevant to Facto improvement observations.
  • Issue & OKR Relevance: Identify events that support or refute open GitHub Issues, reveal Facto problems against OKR targets, or represent notable failures.
  • Confirmation Process: Uses a confidence-based approach, auto-filing confident matches and requesting confirmation for uncertain ones.
  • Use Case: For a developer working with Facto, this Skill helps streamline the process of identifying areas for improvement in software development workflows.

Quick Start

Run the mine-logs skill to analyze the current Claude Code session log and automatically file observations as Facto improvement items.

Frequently Asked Questions about mine-logs

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

FAQPage Schema
How do I automate Claude Code session log analysis for improvement observations?

You can automate session log analysis by running a skill that scans Claude Code logs to identify events relevant for Facto improvement observations, auto-filing confident matches and requesting confirmation for uncertain ones.

What are Facto improvement observations and how do session logs support them?

Facto improvement observations are events identified in Claude Code session logs that support or refute open GitHub Issues, reveal problems against OKR targets, or represent notable failures requiring workflow attention.

Do I need GitHub API authentication to analyze Claude Code session logs?

Yes, GitHub API authentication is required to automatically file observations that support or refute open GitHub Issues, along with Facto settings to identify the relevant project and Issue statuses.

How does automated log analysis handle uncertain matches against GitHub issues?

The session log analysis uses a confidence-based approach, automatically filing high-confidence observations while requesting user confirmation for uncertain matches before submitting them to Facto or GitHub Issues.

Can I use session log analysis to track problems against OKR targets?

Yes, the session log analysis identifies events in Claude Code logs that reveal Facto problems against OKR targets, automatically filing them as improvement observations for tracking and resolution.