project-context-loader

Load project conventions and generate session context. Use EXPLICITLY when needed, not automatically.

14 stars

Best use case

project-context-loader is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Load project conventions and generate session context. Use EXPLICITLY when needed, not automatically.

Teams using project-context-loader should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/project-context-loader/SKILL.md --create-dirs "https://raw.githubusercontent.com/nguyenthienthanh/aura-frog/main/aura-frog/skills/project-context-loader/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/project-context-loader/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How project-context-loader Compares

Feature / Agent	project-context-loader	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Load project conventions and generate session context. Use EXPLICITLY when needed, not automatically.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

> **AI-consumed reference.** Optimized for Claude to read during execution.
> Human-readable explanation: see [docs/architecture/HIERARCHICAL_PLANNING.md](../../../docs/architecture/HIERARCHICAL_PLANNING.md)
> or [docs/getting-started/](../../../docs/getting-started/) depending on topic.


# Project Context Loader

Load project conventions and generate session context on demand.

---

## When to Use

**Before:** `/run`, code generation, refactoring, test writing.
**Skip:** Simple questions (no code), when `session-context.toon` already loaded.

---

## Loading Process

### 1. Check Cache
If `.claude/session-context.toon` exists and is recent (< 1 hour), use it.

### 2. Generate (If Missing)
Scan codebase for: file naming, import style, export pattern, error handling, testing framework, styling approach. Write to `.claude/session-context.toon`.

### 3. Load Project Config
From `.claude/project-contexts/[project]/`:

| File | When |
|------|------|
| `project-config.yaml` | Always |
| `conventions.md` | Always |
| `rules.md` | Always |
| `repo-map.md` | First task |
| `file-registry.yaml` | When modifying code |
| `architecture.md` | Architecture decisions |

### 4. Smart Loading

```toon
loading_strategy[4]{scenario,files_to_load}:
  Simple question,session-context.toon only
  Bug fix / small change,"session-context.toon + conventions.md + file-registry.yaml"
  New feature / refactor,All 7 files
  Architecture decision,"session-context.toon + architecture.md + repo-map.md"
```

**Token budget:** Simple ~200, Bug fix ~800, Full ~2000, Architecture ~1000.

---

## Session Context Template

```toon
project:
  name: {name}
  stack: {detected}

patterns[7]{type,convention,example}:
  file_naming,PascalCase,UserProfile.tsx
  imports,absolute @/,import { Button } from '@/components/Button'
  exports,named,export const UserCard = ...
  errors,result,return { ok: true, data }
  testing,vitest,describe('UserCard', () => ...)
  styling,tailwind,className="flex items-center"
  ...
```

---

## Commands

- `bash scripts/context-compress.sh` -- generate context
- `rm .claude/session-context.toon` -- force rescan

---

Related Skills

We are still matching the closest adjacent skills for this page. In the meantime, continue through the full directory.