file-size-gatekeeper

Audit configuration and skill files for character count thresholds.

2|Updated Apr 30, 2026

Search Tags:#performance #skills #maintenance #config #context-window #housekeeping

Ready to run

npx skills add https://github.com/ShaggyD/agent-toolkit --skill file-size-gatekeeper

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: file-size-gatekeeper
Source: https://github.com/ShaggyD/agent-toolkit/tree/main/productivity/file-size-gatekeeper
Command: npx skills add https://github.com/ShaggyD/agent-toolkit --skill file-size-gatekeeper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents silent performance degradation caused by bloated configuration and instruction files that consume valuable context window space.

Core Features & Use Cases

Threshold Monitoring: Automatically flags files exceeding 17,000 or 18,000 characters to prevent the 18,000 character trap.
Audit & Maintenance: Provides commands to audit file sizes across your entire agent environment and offers strategies for splitting or condensing oversized files.
Use Case: When your agent begins ignoring instructions or behaving inconsistently, use this skill to identify and trim bloated SKILL.md or configuration files to restore optimal performance.

Quick Start

Run the file size gatekeeper audit to identify which configuration or skill files are currently exceeding the recommended character thresholds.

Frequently Asked Questions about file-size-gatekeeper

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

FAQPage Schema

Why does my AI agent ignore instructions and behave inconsistently?▼

Agent instruction degradation happens when bloated configuration files exhaust the context window. Monitoring critical system files and trimming oversized SKILL.md documents restores optimal agent performance and instruction adherence.

How do I audit file sizes to prevent context window bloat?▼

Run an automated file size audit to identify configuration and skill documentation exceeding character count thresholds. This flags files over 17,000 characters to prevent the 18,000 character trap and maintain agent performance.

What is the character limit for agent configuration files?▼

The recommended threshold for agent configuration files is 17,000 to 18,000 characters. Exceeding this limit triggers silent instruction degradation and context window exhaustion, requiring file-splitting strategies to maintain performance.

What's the best way to split oversized skill documentation files?▼

Use automated auditing and file-splitting strategies to condense oversized configuration files. This enforces file size discipline on agent instruction files, preventing context window bloat and restoring optimal instruction adherence.