agents-md-upfactor

Capture session learnings into AGENTS.md and reorganize files with preview approval.

Updated Mar 19, 2026

Search Tags:#documentation #agents #organization #refactor #agents.md #workflows

Ready to run

npx skills add https://github.com/japurcell/skills --skill agents-md-upfactor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agents-md-upfactor
Source: https://github.com/japurcell/skills/tree/main/skills/agents-md-upfactor
Command: npx skills add https://github.com/japurcell/skills --skill agents-md-upfactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps capture durable session learnings into AGENTS.md and cleanly reorganize all AGENTS.md files for clarity, ensuring consistent guidance across multiple documents.

Core Features & Use Cases

Phase-driven learnings capture: discovers existing AGENTS.md files, extracts actionable insights, and records them in a concise, repeatable format.
Structural cleanup: identifies and resolves redundancy, splits content into topic-specific files, and reduces root-file bloat.
Preview and approval: presents a combined preview of changes before applying edits.

Quick Start

Summarize the current session into AGENTS.md and perform a targeted reorganization of all AGENTS.md files for clarity.

Frequently Asked Questions about agents-md-upfactor

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

FAQPage Schema

How do I capture session learnings into AGENTS.md files?▼

To capture session learnings into AGENTS.md, this skill discovers existing files, extracts actionable insights, and records them in a concise format. It operates in three phases: discover, draft learnings, and optional refactor.

What is the best way to reorganize multiple AGENTS.md files for clarity?▼

Reorganizing multiple AGENTS.md files for clarity involves identifying and resolving redundancy, splitting content into topic-specific files, and reducing root-file bloat. This skill automates that structural cleanup through a targeted refactor phase.

Can I preview AGENTS.md changes before applying edits?▼

Yes, you can preview AGENTS.md changes before edits are applied. The workflow presents a combined approval preview of proposed learnings and structural updates, ensuring you can review modifications before they are committed.

How does the AGENTS.md cleanup workflow handle redundant documentation?▼

The AGENTS.md cleanup workflow handles redundant documentation by identifying overlapping guidance across multiple files. It then resolves redundancy by splitting content into topic-specific files to reduce root-file bloat.

Do I need existing AGENTS.md files to use this documentation refactor workflow?▼

No, you do not need existing AGENTS.md files to start. The workflow's initial discovery phase scans for current files and can establish a clean, organized structure from scratch to capture new session learnings.

When should I refresh agent instructions across multiple documentation files?▼

You should refresh agent instructions when session learnings accumulate or guidance becomes redundant across multiple files. This skill consolidates durable insights and enforces consistent documentation structure through a three-phase workflow.