process-journals

Extract knowledge from journal entries into ADRs and guides.

Updated Oct 11, 2025
One-click install
npx skills add https://github.com/tnez/docent --skill process-journals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: process-journals
Source: https://github.com/tnez/docent/tree/main/skills/docent/process-journals
Command: npx skills add https://github.com/tnez/docent --skill process-journals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git cli.

What problem does it solve?

Raw journal entries and notes often contain valuable insights that get lost over time if not formalized. This Skill provides a systematic workflow to review these ephemeral records, extract critical architecture decisions, implementation insights, and project context, and integrate them into permanent, searchable documentation.

Core Features & Use Cases

  • Journal Review: Guides through scanning recent journal entries for key information.
  • Knowledge Extraction: Facilitates creating ADRs for decisions, updating guides with insights, and enriching project context.
  • Cleanup & Archiving: Organizes processed journals by archiving them, keeping your active knowledge base clean.
  • Use Case: After a week of intense development, your journal is full of discoveries. Use this Skill to systematically review your entries, automatically create an ADR for a critical architectural decision, update a troubleshooting guide with a new solution, and archive your old notes, ensuring no valuable knowledge is lost.

Quick Start

Process my recent journal entries and extract key knowledge.

Frequently Asked Questions about process-journals

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

FAQPage Schema
How do I extract architecture decisions from my journal entries into formal documentation?

Extract architecture decisions by reviewing journal entries for key decisions, then generate ADRs that capture the decision, rationale, date, and alternatives considered. This Skill automates the process of identifying and formalizing these decisions into permanent, searchable documentation.

What's the best way to convert raw notes into structured knowledge management documents?

Process your notes systematically to identify valuable insights, then transform them into structured outputs like ADRs, guides, READMEs, and troubleshooting docs. The Skill extracts implementation insights and project context, organizing them into formal documentation while archiving processed entries.

Can I automate extracting knowledge from journal entries and updating documentation?

Yes. This Skill automates reviewing journal entries, extracting critical discoveries, generating ADRs for decisions, updating guides with insights, and committing changes to git. It produces a summary report and archives processed journals, keeping your knowledge base clean and current.

How do I organize and archive old journal entries after extracting their value?

After processing journals to extract knowledge, the Skill archives or deletes processed entries based on your configuration. This cleanup keeps your active knowledge base organized while preserving extracted insights in formal documentation.

What information should I capture in journals to make knowledge extraction effective?

Journals should document architecture decisions with context, implementation discoveries, rationale, patterns identified, and problems solved. The Skill identifies this valuable content and formalizes it into ADRs, guides, and troubleshooting docs for permanent reference.

Do I need git to process and commit my extracted knowledge from journals?

Yes. Git CLI is required to commit the changes produced by processing journals—including new ADRs, updated documentation, changelog entries, and archived journal records.