When does the Project Context Loader run?

It is set to auto-invoke before any workflow starts, before code generation, and before implementation tasks to ensure the AI always has the latest context.

What patterns does it automatically detect?

It scans for file naming conventions (PascalCase/kebab-case), import styles (absolute/relative), export patterns, error handling methods, and specific testing frameworks.

Can I manually trigger a context refresh?

Yes, you can force a rescan by deleting the .claude/session-context.toon file or running the context-compress script manually.

How does this skill reduce token usage?

It compresses verbose documentation and codebase patterns into a structured '.toon' file, reducing context overhead by up to 85% compared to passing full convention documents.

Does it support custom project rules?

Yes, it merges detected patterns with any project-specific rules found in .claude/project-contexts/ to ensure local overrides are respected.

Project Context Loader

Name: Project Context Loader
Author: nguyenthienthanh

bynguyenthienthanh

•

Productivity & Workflow

Automatically synchronizes project conventions and session state to ensure consistent AI code generation with minimal token overhead.

The Project Context Loader is a high-priority skill for Aura Frog that proactively scans your codebase to establish a source of truth for project conventions. By detecting file naming patterns, import styles, and error-handling preferences, it generates a compressed '.toon' session file that significantly reduces token usage while keeping the AI aligned with your specific architecture. This skill ensures that every code generation task adheres to your existing project rules and architectural decisions without requiring manual prompt engineering for every request.

Key Features

01Cached context management with TTL-based expiration for performance

02High-efficiency .toon context file generation with 85% token savings

03Automated codebase pattern scanning for naming, imports, and exports

04Proactive auto-invocation before workflows and code generation tasks

05Hierarchical configuration merging from project-specific rules and core defaults

061 GitHub stars

Use Cases

01Rapidly onboarding the AI to a new codebase with complex or unique conventions

02Maintaining consistent coding styles and architectural patterns across large team projects

03Reducing token costs and latency in long-running Claude Code development sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nguyenthienthanh/aura-frog project-context-loader

For use in Claude.ai and ChatGPT

Download Skill