Is it safe to run this maintenance skill?

Yes. The skill is designed with a backup-first policy, creating a timestamped backup of your config and keeping the last three versions automatically.

Will I lose my project permissions?

The skill performs a partial cleanup of project entries, typically preserving your most recent 30 days of activity while clearing out older, stale metadata.

How do I know if I need to use this skill?

You should use it if you encounter an error message stating 'File content exceeds maximum allowed tokens' or if you notice Claude struggling to recall your local configuration.

Why does my ~/.claude.json file get too large?

Claude Code stores cached changelogs, feature flags, and project history in this file. Over time, these can exceed 25K tokens, causing readability issues for the AI.

Claude Config Optimizer

Name: Claude Config Optimizer
Author: theflysurfer

bytheflysurfer

•

Productivity & Workflow

Optimizes and cleans the Claude Code configuration file to prevent token limit errors and maintain environment performance.

This skill provides a specialized maintenance workflow for managing your ~/.claude.json configuration file. It is specifically designed to address instances where the configuration grows too large (exceeding 25K tokens), which can prevent Claude from reading its own settings. The skill automates the diagnosis of space-consuming sections, performs safe cleanups of cached data like changelogs and feature flags, and includes an intelligent pruning system for project history, all while maintaining a robust backup policy to ensure no data loss occurs.

Key Features

01Automated cleanup of non-essential cached metadata

021 GitHub stars

03Automatic rolling backup system for configuration safety

04Interactive workflow to verify file readability post-cleanup

05Diagnostic reporting of token usage per config section

06Intelligent pruning of project history older than 30 days

Use Cases

01Periodic maintenance to keep local Claude configuration lean

02Resolving 'File content exceeds maximum allowed tokens' errors

03Fixing issues where Claude cannot read the ~/.claude.json file

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add theflysurfer/claude-skills-marketplace julien-maintenance-claude-json

For use in Claude.ai and ChatGPT

Download Skill