context-builder

Generate structured markdown context from a directory for AI analysis.

29|5|Updated Sep 11, 2025
One-click install
npx skills add https://github.com/igorls/context-builder --skill context-builder-igorls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-builder
Source: https://github.com/igorls/context-builder/tree/main
Command: npx skills add https://github.com/igorls/context-builder --skill context-builder-igorls

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires context-builder, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill generates a comprehensive markdown context file from any directory, enabling effective AI analysis by streamlining code review and knowledge discovery processes.

Core Features & Use Cases

  • Codebase Aggregation: Recursively processes directories to include all necessary files.
  • Relevance-Based File Ordering: Prioritizes critical project files for quicker AI analysis.
  • Context Budgeting: Limits the output to fit within the AI model's context window.
  • AST Signatures & Structure: Optionally includes AST signatures and structural summaries for deeper analysis.
  • Use Case: Use this skill to generate a context file for a Rust project, providing an AI with a clear, structured view of the codebase for analysis or code review.

Quick Start

Use the context-builder skill to generate a context file for the directory '/path/to/project' and output to 'project-context.md'.

Frequently Asked Questions about context-builder

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

FAQPage Schema
How do I generate a markdown context from my codebase for AI analysis?

Generating a markdown context for AI analysis involves recursively processing your project directory to aggregate files into a structured output. The context-builder skill filters by relevance and optionally adds AST signatures for deeper AI code review.

What is the best way to prepare a large project directory for AI code review?

Preparing a large project for AI code review requires context budgeting to fit the AI model's context window. The context-builder skill prioritizes critical project files and applies ignoring patterns to optimize the generated markdown output.

Does context-builder support AST-based features for codebase analysis?

Yes, context-builder supports AST signatures and structural summaries. These AST-based features provide deeper analysis by embedding code structure metadata within the generated markdown context file for AI processing.

Do I need the context-builder CLI tool to generate codebase context files?

Yes, you need the context-builder CLI tool installed to use this skill. The skill requires the CLI dependency, available at https://github.com/igorls/context-builder, to process directories and generate the markdown output.

Can I filter files and ignore patterns when creating a markdown context from a directory?

Yes, you can filter files and apply ignoring patterns when creating a markdown context. The context-builder skill supports file filtering and ignore patterns to ensure only relevant code is included for the AI analysis context window.

Why does my AI analysis fail when processing a large codebase context?

AI analysis may fail when a codebase context exceeds the model's context window. Context-builder resolves this by applying context budgeting and relevance-based file ordering to limit and prioritize the markdown output within the AI's limits.