punchout

Aggregate day-query results into a timestamped org-mode journal entry.

6|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/junghan0611/agent-config --skill punchout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: punchout
Source: https://github.com/junghan0611/agent-config/tree/main/skills/punchout
Command: npx skills add https://github.com/junghan0611/agent-config --skill punchout

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

punchout provides a reliable, one-step way to write today's day-end summary into your org-mode journal by collecting day-query results and inserting them at the correct place. It eliminates manual journaling work by automating data aggregation and formatting according to a strict org-mode template.

Core Features & Use Cases

  • Automates day-end journaling by aggregating outputs from day-query tools (git history, notes, lifetract data) into a single org-mode entry.
  • Inserts the entry into today's journal at the correct position, preserving existing content and maintaining a consistent format.
  • Use Case: end-of-day workflow for personal productivity, project retrospectives, or daily logging.

Quick Start

Run punchout to generate today's org-mode journal entry from day-query results.

Frequently Asked Questions about punchout

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

FAQPage Schema
How do I automate daily journaling in org-mode?

Automating day-end journaling in org-mode involves aggregating data from sources like git history and notes into a single timestamped entry. The tool collects day-query results and inserts them deterministically into today's journal before the NEWNOTES header or at the end if absent.

What is the best way to write a day-end summary to an org-mode journal?

The best way to write a day-end summary is using a tool that applies precise insertion rules to place aggregated daily data into an org-compatible template. It formats outputs from multiple sources into one deterministic org-mode entry without manual formatting.

Do I need day-query data sources to generate org-mode journal entries?

Yes, day-query data sources are required to generate org-mode journal entries. The tool aggregates outputs from sources like git history, notes, and lifetract data to produce a single formatted daily wrap-up entry in your org-mode journal.

How does org-mode journal insertion handle existing content?

Org-mode journal insertion preserves existing content by applying precise insertion rules to place the new entry before the NEWNOTES header. If the header is absent, the entry is placed at the end of the journal to maintain a consistent format.

Can I use punchout for project retrospectives and daily logging?

Yes, you can use punchout for project retrospectives and daily logging. It automates the end-of-day workflow by aggregating data from multiple sources into a single org-mode journal entry for personal productivity tracking.

What are the limitations of automating org-mode journal entries?

Limitations of automating org-mode journal entries include the strict dependency on day-query data sources and an org-compatible template. The insertion logic is deterministic and requires a NEWNOTES header for precise placement or defaults to the end of the file.