session-report

Generate structured session reports with incremental updates and git validation.

3|1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/nsheaps/ai-mktpl --skill session-report-nsheaps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-report
Source: https://github.com/nsheaps/ai-mktpl/tree/main/plugins/session-report/skills/session-report
Command: npx skills add https://github.com/nsheaps/ai-mktpl --skill session-report-nsheaps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many sessions produce scattered commits, issues, PRs, failures, and informal notes that are hard to consolidate later; this skill provides a structured, repeatable process to capture work as it happens and produce an accurate, reviewable session report. It reduces post-session overhead by enforcing incremental, append-only updates, ensuring attribution, and automating validation against git and GitHub sources.

Core Features & Use Cases

  • Create at session start: Initialize a templated report or resume an existing one without overwriting prior entries.
  • Incremental updates: Contributors append commits, PRs, issues, failure logs, and artifacts throughout the day using role-specific rules.
  • Finalization and validation: Compile the report, verify counts against git/gh data, run a security scan for secrets, and prepare a reviewed deliverable for Obsidian.
  • Use cases: Solo agents tracking personal progress, multi-agent teams coordinating across repos, and team leads producing end-of-session deliverables with exact commit/issue references.

Quick Start

Create a session report for today, append my recent commits and open issues, validate links and counts, and finalize the report for commit.

Frequently Asked Questions about session-report

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

FAQPage Schema
How do I generate a daily session report from git commits and GitHub issues?

To generate a daily session report from git commits and GitHub issues, you can initialize a templated report and append your recent work activity. The report is then validated against git and GitHub data to ensure accurate counts and clickable references before finalization.

What is the best way to track scattered commits and PRs for a multi-agent team?

The best way to track scattered commits and PRs for a multi-agent team is to use a structured, append-only session report. This enforces attribution and allows contributors to incrementally update progress across repositories using role-specific rules.

Can I export my finalized session report to Obsidian?

Yes, you can export your finalized session report to Obsidian. The finalization process compiles the report, verifies counts against git and GitHub sources, and prepares a reviewed deliverable formatted for Obsidian.

How do incremental updates work when resuming an existing session report?

Incremental updates work by appending new commits, PRs, issues, and failure logs to a resumed report without overwriting prior entries. This append-only process captures work as it happens and enforces accurate attribution throughout the day.

Does the session report generation process include security scanning?

Yes, the session report generation process includes a pre-commit security scan. During finalization, the report is scanned for secrets to ensure the deliverable is safe before being committed.

What's the best way to validate commit counts in a daily development summary?

The best way to validate commit counts in a daily development summary is to cross-reference the report against live git and GitHub data. This automated validation step ensures that all clickable links and references match the actual repository state.