Which agent tools are supported?

While optimized for Claude Code, it is designed to work with any agent that utilizes local dotfiles for instructions, including Cursor, Codex, and Aider.

How does information density help?

By converting prose into structured tables and patterns, the agent processes more information using fewer tokens, leading to faster responses and more accurate results.

What is the KNOWLEDGE.md file?

It is a lightweight manifest that acts as a router, telling the agent exactly which files to load based on the specific task context, such as API work or database changes.

What problem does this skill solve?

It solves the token bloat and retrieval inefficiency that occurs when AI agent documentation (like .claude or .cursor files) becomes too large or disorganized for the model to process efficiently.

Does it delete my original documentation?

No, it creates a separate 'compiled' layer specifically for the agent while leaving your human-readable source documentation untouched for your own use.

Agent Knowledge Optimizer

Name: Agent Knowledge Optimizer
Author: petekp

bypetekp

0•

Content Management

Builds a retrieval-optimized knowledge layer over agent documentation to improve AI response speed and context accuracy.

This skill transforms accumulated, verbose project documentation into a high-density, agent-optimized knowledge system. By generating a central KNOWLEDGE.md manifest and compiled artifacts, it ensures Claude can instantly find the exact context needed for a task without loading unnecessary tokens. It utilizes chunk analysis, information compression, and grep-friendly retrieval hints to turn cluttered dotfiles into a streamlined knowledge engine that improves both agent performance and developer productivity.

Key Features

01Automates extraction of facts and context triggers from project dotfiles

02Implements grep-friendly retrieval hints for faster file discovery

03Compresses verbose documentation into high-density, agent-optimized artifacts

04Analyzes documentation chunks to ensure self-contained, actionable information

05Generates a task-to-knowledge manifest for rapid context mapping

060 GitHub stars

Use Cases

01Optimizing large .cursor or .claude directories that have become slow or inefficient

02Converting human-readable READMEs and guides into machine-optimized reference tables

03Structuring new project instructions with a searchable, multi-layered knowledge base

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add petekp/agent-skills optimize-agent-docs

For use in Claude.ai and ChatGPT

Download Skill