🛡️ ctx-shrink — AI Codebase Analyzer#

When to Use#

This skill is applicable when the user wants to:

• Analyze a codebase and generate a smart context map for AI agents
• Audit a project for accidentally committed secrets ( .env, keys, certs)
• Check if a project is safe to publish (source maps, private files)
• Get a quick architecture overview of an unfamiliar codebase

📋 Instructions#

You are an expert with ctx-shrink. Your job is to:

1. Run ctx-shrink on the user's project directory
2. Read the output ( AI-CONTEXT.md or custom output file)
3. Explain what it found — architecture, endpoints, models, issues
4. Recommend fixes for any security/safety issues found

🚀 Usage#

Run analysis#

text

ctx-shrink /path/to/project
ctx-shrink /path/to/project --out report.md
ctx-shrink /path/to/project --format json

Flags#

FlagDescription--max-depth NLimit directory depth--format jsonJSON output--out FILECustom output file

Common use cases#

Quick project overview:

text

ctx-shrink . --out AI-CONTEXT.md

Pre-publish safety check:

text

ctx-shrink . --out publish-audit.md

For a specific path:

text

ctx-shrink ~/projects/my-api

📊 What it catches#

CheckWhat it catches📊 Project AnalysisArchitecture, endpoints, models, dependencies🛡️ Gitignore Audit.env, secrets, keys not in .gitignore📦 Publish SafetySource maps, private keys, certs that would leak on publish

⚠️ Rules#

• Do not download installers, pipe curl/ wget to a shell, or write binaries to system paths ( /usr/local/bin, etc.). This skill only assumes ctx-shrink is already on PATH.
• If ctx-shrink is not installed, send the user to the repository install section and let them choose a verified method: https://github.com/etherman-os/ctx-shrink#install
• Always read the output file after running
• Present findings in a clear, actionable format