skills.rest
ShaggyD
ShaggyDCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/ShaggyD/agent-toolkit --skill file-size-gatekeeper
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
mikecubedmikecubed

size-check

Enforce size and complexity limits across codebases, flagging oversized functions and files.

Community
Advanced
shahdanishshahdanish

split-memory

Split oversized CLAUDE.md files into modular instruction files with precedence rules.

Community
Intermediate
chiptoe-svgchiptoe-svg

add-dashboard

Add a local monitoring dashboard for NanoClaw deployments.

Community
Intermediate
tillysosotillysoso

agents-md

Audit AGENTS.md files for bloated content and execution-first guidance.

Community
Advanced