Does it support monorepos?

Yes, it automatically detects project structures via package.json workspaces, pnpm-workspace.yaml, and directory analysis to handle sub-packages.

Can I review changes before they are applied?

Yes, the skill follows a strict confirmation flow where it analyzes content, proposes changes, and waits for user approval before writing to disk.

How does it handle the Single Source of Truth (SSOT)?

It reconfigures CLAUDE.md to act as a reference point for AGENTS.md, ensuring that AI instructions are centralized and not duplicated.

What files does this skill modify?

It primarily manages and synchronizes AGENTS.md, README.md, CLAUDE.md, and rule files located within the .claude/rules directory.

Project Context Refactor

Name: Project Context Refactor
Author: masseater

bymasseater

•

学習とドキュメンテーション

Organizes and synchronizes project-wide context files like AGENTS.md and README.md to ensure AI instruction consistency.

This skill automates the maintenance of project context files, ensuring that AI agents have clear, updated, and consistent instructions across your entire repository. It intelligently detects project structures (including monorepos), migrates AI-specific content from READMEs to dedicated AGENTS.md files, and establishes a Single Source of Truth (SSOT) by linking CLAUDE.md to centralized rule sets. By standardizing documentation formats and keeping command lists synchronized, it significantly improves the reliability and accuracy of AI interactions within your codebase.

主な機能

01Establishes AGENTS.md as the Single Source of Truth (SSOT) for AI instructions

021 GitHub stars

03Automatic detection of monorepo structures and sub-package workspaces

04Interactive confirmation flow for analyzing and approving all file changes

05Extracts AI-specific context from README.md into organized .claude rules

06Synchronizes slash commands and npm scripts across project documentation

ユースケース

01Standardizing AI documentation across a large monorepo for better agent performance

02Ensuring CLAUDE.md files are correctly linked to centralized project rules and gotchas

03Cleaning up README files by moving technical constraints to dedicated AGENTS.md files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add masseater/claude-code-plugin refactor-project-context

For use in Claude.ai and ChatGPT

Download Skill