Engineering Advanced Claude CodeCLAUDE.mdAI Config

Claude Code Config

Generate optimized CLAUDE.md files, memory configs, and project instructions for Claude Code. Analyzes codebase to create tailored AI context.

A configuration skill for teams using Claude Code as their primary AI coding assistant. It analyzes your project structure, tech stack, and coding conventions to generate a CLAUDE.md that gives Claude the right context upfront — reducing clarifying questions, preventing convention violations, and improving first-attempt code quality.

Added Mar 20, 2026

$npx skills add johnefemer/skillfish --skill claude-code-config

Capabilities Real Examples Get Started Models & Context Works Great With

What This Skill Can Do

Concrete capabilities you get when you install this skill.

Analyze project structure and generate a comprehensive CLAUDE.md from scratch

Write project commands section covering build, test, lint, and dev server invocations

Encode codebase conventions: naming, import order, error handling, and testing patterns

Configure memory files and context loading for large multi-service projects

Write per-directory CLAUDE.md files for mono-repos with different conventions per package

Audit existing CLAUDE.md files for missing context and conflicting instructions

Real Conversations

See how the Claude Code Config skill responds to actual requests. These are representative examples of what your AI agent will produce.

You

Can you help me create an effective CLAUDE.md for my Next.js 14 + Supabase + Tailwind project?

Agent

Here's a production CLAUDE.md template for your stack — customize to match your actual patterns:

# CLAUDE.md

## Project Overview
Next.js 14 app (App Router) with Supabase backend and Tailwind CSS.

## Commands
```bash
npm run dev          # start dev server (localhost:3000)
npm run build        # production build
npm run test         # Jest + Testing Library
npm run lint         # ESLint + TypeScript check
npx supabase start   # start local Supabase (Docker required)
npx supabase db push # apply pending migrations

Architecture

app/ — Next.js App Router pages and layouts
app/api/ — Route handlers (server-side API endpoints)
components/ — Shared React components
lib/supabase/ — Supabase client (client.ts = browser, server.ts = server component)
types/database.ts — Auto-generated Supabase types (do not edit manually)

Conventions

Use lib/supabase/server.ts in Server Components and Route Handlers
Use lib/supabase/client.ts only in Client Components
All DB queries go through lib/queries/ — never inline Supabase calls in components
RLS must be enabled on every table — document the policy in a comment above the migration
Tailwind only — no inline styles, no CSS modules
use client only when genuinely needed (interactivity/browser APIs)

Testing

Unit tests: co-located *.test.ts files
Integration tests: tests/ directory with Supabase local instance
Never mock Supabase in integration tests — use local instance

Do Not

Do not call supabase.from() outside lib/queries/
Do not use Pages Router patterns (getServerSideProps, etc.)
Do not commit .env.local


Share your actual `app/` structure and `lib/` layout and I'll tailor the architecture section precisely.

You

Claude Code keeps generating imports with relative paths like ../../components/Button when we use absolute paths with @/ everywhere. How do I fix this in CLAUDE.md?

Agent

This is a classic convention-encoding problem. The fix is a combination of explicit rule, negative example, and TypeScript config reference:

## Import Conventions

**Always use absolute imports with the `@/` alias.**

```ts
// CORRECT
import { Button } from '@/components/ui/Button';
import { useAuth } from '@/hooks/useAuth';
import type { User } from '@/types/user';

// WRONG — never generate relative imports that traverse directories
import { Button } from '../../components/ui/Button';
import { useAuth } from '../hooks/useAuth';

The @/ alias maps to ./src/ — configured in tsconfig.json:

{ "compilerOptions": { "paths": { "@/*": ["./src/*"] } } }

Exception: imports within the same directory may use ./ relative paths.


**Why this works:** Claude reads CLAUDE.md at the start of every session. The explicit wrong/right example with `// WRONG` labels is processed as a strong constraint. The tsconfig reference explains *why* the alias works — Claude won't doubt the pattern and revert to relative paths.

**Pro tip:** Put your most-violated conventions at the top of the Conventions section — CLAUDE.md is read sequentially and earlier sections carry more weight in practice.

Get Started

How to install and use this skill in your preferred environment.

Skills are designed for AI coding agents (Claude Code, Cursor, Windsurf) and IDE-based workflows where the agent can read files, run scripts, and act on your codebase.

Models & Context

Which AI models and context windows work best with this skill.

Recommended Models

Best with Claude Sonnet or Claude Opus — this skill is specifically optimized for Claude Code's context format. Works adequately with GPT-4o but instructions are Claude-specific.

Context Window

SKILL.md is ~7KB. Load your current CLAUDE.md and representative source files for audit and improvement sessions.

Pro tips for best results

1

Be specific

Include numbers — users, budget, RPS — so the skill can size the architecture.

2

Share constraints

Compliance needs, team size, and existing stack all improve the output.

3

Iterate

Start with a high-level design, then ask follow-ups for IaC, cost analysis, or security review.

4

Combine skills

Pair with companion skills below for end-to-end coverage.

Works Great With

These skills complement Claude Code Config for end-to-end coverage. Install them together for better results.

Cursor Rules Engineer

Create optimized .cursorrules and AI editor configuration files from codebase analysis. Boost AI coding assistant accuracy and consistency.

CursorAI Editor

Codebase Onboarding

Auto-generate onboarding docs from codebase analysis.

OnboardingDocumentation

Self-Improving Agent

Curate auto-memory into durable project knowledge, promote patterns to rules.

AgentMemory

Vibe Coding Guide

Structured AI-pair-programming: prompt decomposition, iterative refinement, context management, quality gates, and session workflows.

Vibe CodingAI Pair Programming

$ skillfish add johnefemer/skillfish --all # install all skills at once

Ready to try Claude Code Config?

Install the skill and start getting expert-level guidance in your workflow — any agent, any IDE.