session-log-fixer

Patch non-compliant session logs in GitHub Actions to meet canonical protocol.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/loriensleafs/brain --skill session-log-fixer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-log-fixer
Source: https://github.com/loriensleafs/brain/tree/main/apps/claude-plugin/skills/session-log-fixer
Command: npx skills add https://github.com/loriensleafs/brain --skill session-log-fixer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill diagnoses and fixes session protocol validation failures in GitHub Actions by applying deterministic corrections to non-compliant session logs, ensuring faster remediation without artifacts.

Core Features & Use Cases

  • Detects NON_COMPLIANT session files from GitHub Actions Job Summaries and identifies missing Session Start / Session End sections
  • Applies canonical templates from SESSION-PROTOCOL.md to restore compliance, including evidence and commit trace
  • Supports targeted fixes by run-id and natural-language activations (e.g., "fix session validation for PR")

Quick Start

Use the skill to fix a specific run: "session-log-fixer: fix run <run-id>" Or trigger via natural language: "fix session validation for PR<PR-number-or-run>"

Frequently Asked Questions about session-log-fixer

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

FAQPage Schema
How do I fix session protocol validation failures in GitHub Actions?

To fix session protocol validation failures, you must patch non-compliant session logs by locating missing MUST/SHOULD sections in the Job Summary and applying canonical templates from SESSION-PROTOCOL.md. This produces a COMPLIANT log with explicit evidence and traceable commits for CI re-runs.

Why does my GitHub Actions run fail session protocol checks due to missing sections?

Your GitHub Actions run fails session protocol checks because the session logs are NON_COMPLIANT, lacking required MUST/SHOULD sections like Session Start or Session End. Detecting these missing sections in the failed Run summaries allows targeted patching to restore canonical compliance.

Can I target a specific GitHub Actions run-id to patch a non-compliant session log?

Yes, you can target a specific GitHub Actions run-id to patch non-compliant session logs by triggering the fix with a natural-language command like "fix session validation for PR". This applies deterministic corrections to the specified run's artifacts.

How do I verify that patched session logs meet canonical protocol requirements before re-running CI?

You verify patched session logs meet canonical protocol requirements by using the local Validate-SessionProtocol.ps1 workflow. This validation checks that the applied templates from SESSION-PROTOCOL.md have successfully restored the session file to a COMPLIANT state.

What is the best way to automate remediation for failed session protocol validations in CI?

The best way to automate remediation for failed session protocol validations is to apply deterministic corrections to non-compliant logs using canonical templates. This process commits traceable changes directly to enable clear artifact reports and immediate CI re-runs without manual intervention.

Does fixing GitHub Actions session logs require external dependencies?

No, fixing GitHub Actions session logs does not require external dependencies. The process relies on local scripts and canonical reference templates to read failed Run summaries, apply patches, and verify compliance using the Validate-SessionProtocol.ps1 workflow.