read

Read and summarize .thoughts files from the highest iteration directory.

1|Updated Jan 24, 2023
One-click install
npx skills add https://github.com/KaiNakamura/dotfiles --skill read-kainakamura
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read
Source: https://github.com/KaiNakamura/dotfiles/tree/main/claude/skills/read
Command: npx skills add https://github.com/KaiNakamura/dotfiles --skill read-kainakamura

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many projects keep iterative notes in a .thoughts directory, but agents and collaborators lack a quick, reliable way to load the current iteration's context into a session. This Skill automates reading the right files and producing a concise summary so users and agents can act with up-to-date information.

Core Features & Use Cases

  • Iteration detection: Finds the highest iteration-NN directory to identify the current iteration.
  • Targeted reading: Reads only the specified files (.thoughts/problem.md, .thoughts/iterations.md, iteration-NN/progress.md, and any user-specified files).
  • Safe, read-only summaries: Produces brief summaries for agent context loading without modifying any files.
  • Use case: Prepare an agent for a planning session by loading the latest progress and problem statements so it can make informed suggestions.

Quick Start

Ask the skill to read the current iteration's .thoughts files and provide a concise summary of key problems and progress.

Frequently Asked Questions about read

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

FAQPage Schema
How do I load .thoughts context files into an agent session for planning?

To load .thoughts context, the read skill accesses the directory in read-only mode, identifies the highest iteration-NN folder, and generates concise summaries of problem.md, iterations.md, and progress.md for immediate agent context loading.

What is the best way to summarize iterative notes from a .thoughts directory?

Summarizing iterative .thoughts notes is done by detecting the highest iteration-NN folder and reading specific files like progress.md and problem.md to produce brief, read-only context summaries for collaborators or agents.

Does the read skill modify files when loading iteration context?

Loading iteration context with the read skill is strictly read-only, meaning it safely summarizes .thoughts files like progress.md and problem.md without modifying any repository files during the session.

Can I specify custom file paths when reading .thoughts directories?

Reading .thoughts directories supports optional user-specified file paths passed via arguments, allowing you to target and summarize specific iterative notes alongside the default problem.md, iterations.md, and progress.md files.

How does iteration detection work for .thoughts directories?

Iteration detection for .thoughts directories works by scanning the folder structure to find and select the highest numbered iteration-NN directory, ensuring the summary reflects the most current iteration context available.

When do I need to load .thoughts context into a session?

Loading .thoughts context is needed when preparing an agent for a planning or review session, requiring up-to-date summaries of the latest problem statements and progress notes from the current iteration-NN folder.