/project:improve

Analyze JSONL session history to propose CLAUDE.md and command file improvements.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/hieutrtr/claude-forge --skill project-improve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /project:improve
Source: https://github.com/hieutrtr/claude-forge/tree/main/.claude-plugin/forge/skills/improve
Command: npx skills add https://github.com/hieutrtr/claude-forge --skill project-improve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you keep Claude Code’s project setup accurate by analyzing your recent session history and proposing targeted updates to CLAUDE.md and command files.

Core Features & Use Cases

  • Find what you keep asking for: Detects repeated question topics and suggests filling missing sections in CLAUDE.md.
  • Spot recurring context pastes: Identifies long repeated inputs you reuse, recommending what to document so you paste less.
  • Convert repeated workflows into commands: Detects recurring tool sequences/manual multi-step tasks and proposes creating or updating command files.
  • Privacy-first improvements: Reads local session JSONL files only, requires explicit consent to analyze, and requires your approval for every change (with a dry-run option).

Quick Start

Run /project:improve --sessions 10 --dry-run to review proposed CLAUDE.md and command updates based on your last 10 sessions without writing any files.

Frequently Asked Questions about /project:improve

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

FAQPage Schema
How do I update CLAUDE.md from local session history automatically?

The tool analyzes local JSONL session files to extract repeated topics and recurring context pastes, then generates ranked proposals for documentation improvements. It requires explicit user approval before applying any changes to your project files.

Can I convert repeated Claude Code workflows into command files?

Yes, the tool detects recurring tool sequences and manual multi-step tasks from your session history to propose creating or updating command automation files. This streamlines frequent actions by converting them into reusable commands.

Does the session analysis tool work without sending data to external servers?

Yes, the tool follows a privacy-first approach by reading local JSONL session files exclusively on your machine. It requires explicit consent to analyze and redacts secrets before processing your session history.

How do I test proposed CLAUDE.md changes before writing files?

Run the tool with the dry-run option to generate ranked proposals based on sampled inputs without writing any files. This allows you to review all suggested documentation and command updates safely before applying them.

What is the best way to stop pasting large recurring context into Claude Code?

Analyze session history for repeated inputs and document that information directly in CLAUDE.md. The tool identifies these recurring patterns and recommends specific sections to add, reducing the need to manually paste large context blocks.

What are the limitations of using session analysis for project documentation?

The tool requires local JSONL session files for parsing and manual approval for every change. It samples large inputs to manage processing, meaning highly fragmented or rare session topics might not generate strong proposals for command files.