M.A.I. Consulting
Reference · Claude

Claude: Skills, CLAUDE.md
and token efficiency

Who this is for: readers at level 6 and 7, who build Skills and agents for colleagues or run Claude Code from the terminal.
What it is: reference material kept for accuracy, not a service. Check the current Claude docs and pricing page before relying on any figure.

What Claude Actually Does Well

Claude's most reliable value is structured, repeatable work embedded into real business workflows. These are the use cases where it consistently outperforms alternatives.

📄

Document Analysis & Extraction

Feed Claude contracts, reports, SOPs, or RFPs and extract structured data, summarize key clauses, flag anomalies, or produce comparison tables. Works best when you define the output schema explicitly.

High ROI
✍️

Long-Form Drafting

Strategy memos, grant proposals, board decks, client reports. Claude handles first drafts and iterative rewrites well. A large context window means it can hold an entire document in scope while editing; the current size per model is on the docs page.

Daily Use
🔁

Multi-Step Research Workflows

Web search + synthesis + citation in a single pass. Claude can search, read multiple sources, and compile an evidence-based summary without needing a human to relay content between steps.

Agentic
💻

Code Generation & Review

Generate, explain, refactor, or debug code in Python, JavaScript, SQL, and most widely used languages. Most effective when given explicit requirements, existing code context, and the environment constraints upfront.

Engineering
📊

Data Interpretation

Upload CSVs, Excel files, or describe datasets and Claude can write analysis code, interpret statistical outputs, spot trends, and produce narratives. Combine with code execution for in-context calculations.

Analytics
🤖

Custom Assistants & Tools

Build purpose-built tools using the API, internal knowledge bots, client intake processors, automated report generators, with CLAUDE.md and skill files controlling behavior precisely.

Custom Build

Skills & CLAUDE.md Files

Two mechanisms that let you encode persistent instructions, domain knowledge, and behavioral rules directly into Claude's working context without restating them every session.

What is CLAUDE.md?

CLAUDE.md is a Markdown file Claude reads at the start of every session within a project or directory. It acts as standing instructions: your organization's style guide, terminology, prohibited behaviors, output formats, and domain context, all loaded automatically.

In Claude Code, CLAUDE.md files are hierarchical: a root-level file sets global defaults, while subdirectory files add context for specific modules or workstreams. This means a legal team and an engineering team can operate with different rules without manual switching.

Practical tip: Put your most-used constraints in CLAUDE.md rather than in every prompt. Anything you repeat more than 3 times per week (response format, tone, citation rules, domain vocabulary) belongs there.

CLAUDE.md Structure

# CLAUDE.md for Project: Consulting Engagements ## Role You are a strategy analyst at M.A.I. Consulting. Responses must be professional, evidence-based, and free of hedging language. ## Output Rules - Use Markdown tables for comparisons - Keep section headings concise - Never add preamble before answers - Cite sources inline as [Source, Year] ## Domain Context Client industry: Public sector + NGOs Primary frameworks: Logic models, ToC, SWOT Internal acronyms: ToR = Terms of Reference ## Prohibited - Do not invent data - Do not recommend tools without evidence - Do not use the word "leverage"

Skills (Slash Commands)

Skills are modular instruction files, typically Markdown, stored in a /skills/ directory and referenced by Claude when a specific task type is triggered. Think of them as specialized agents within a project: one skill for writing reports, another for code review, another for client intake processing.

📋

SKILL.md Anatomy

Each skill file has a name, a description (used to trigger it automatically), and a body with exact instructions. The description is critical: it determines when Claude picks up the skill.

📁

File Organization

In Claude Code, project skills live under .claude/skills/ in the repository, shared with everyone who clones it, and personal skills under ~/.claude/skills/. Check the docs for how the two are resolved when names overlap.

🔗

Reference Files

Skills can reference sub-documents (branding guides, templates, code snippets) stored alongside them. This keeps the main SKILL.md short and readable while offloading detail into targeted references Claude reads when needed.

⚡

Slash Commands

In Claude Code, a skill can be invoked by name as a slash command; in the Claude apps, skills are picked up from their description when a task matches. Either way a team gets a shared palette of pre-configured workflows without memorising syntax.

Claude Code

Claude Code is a command-line agentic coding tool. It is neither a chat interface nor a copilot plugin. It operates autonomously on your local filesystem, runs commands, reads and writes files, and executes multi-step tasks with minimal hand-holding.

What it actually does

1

Reads your codebase

Claude Code maps your project structure, reads relevant files, and builds context before touching anything. It doesn't require you to paste code into a chat window.

2

Executes terminal commands

It can run tests, install packages, call build tools, and interpret the output, then adjust its approach based on what failed or succeeded.

3

Handles multi-file changes

A single instruction like "refactor this module to use async/await throughout" results in coordinated edits across multiple files, with Claude tracking dependencies.

4

Responds to CLAUDE.md

Drop a CLAUDE.md in any directory and Claude Code reads it automatically. Nested files let you set different rules per subsystem without modifying the main config.

Practical applications

Codebase onboarding

Ask Claude Code to explain an unfamiliar repository, it reads the structure, key files, and build config and produces a summary more useful than most READMEs.

Automated testing

Generate unit and integration tests for existing code, run them, interpret failures, and iterate until they pass, without copying anything into a browser.

Migration tasks

API version upgrades, framework migrations, dependency updates: tasks that are mechanical but tedious. Claude Code handles the bulk edits while you review diffs.

MCP server integration

Claude Code supports MCP (Model Context Protocol), allowing it to connect to external tools (databases, APIs, file systems) and act on them directly within a session.

Cost note: Claude Code is token-intensive by design. Each agentic step reads files and generates intermediate reasoning. Use /compact mode and targeted file scope to control spend on large repos.

How to Save Credits & Tokens

Token spend is the primary cost lever when using Claude at scale. Most waste comes from three sources: oversized contexts, repetitive system prompts, and unnecessarily long outputs. Each is fixable.

Where the money goes. Input tokens usually dominate a bill, because every call resends the context; output tokens are priced higher per token but there are fewer of them. Model tiers differ in price by a wide margin, cached input is billed at a fraction of the normal rate, and the Batch API is discounted for work that can wait. The exact figures change: check the current pricing page and the docs before building a budget on any of them.

🗂️

Prompt Caching

If you send a long system prompt or large document repeatedly (e.g., a knowledge base), use Anthropic's prompt caching API feature. Cached input is billed at a much lower rate per re-use, and the cache expires after a short period of inactivity. The current rate and lifetime are on the pricing page and in the docs.

API Only High Impact
🎯

Model Selection

Don't use Opus for every task. Claude Haiku handles classification, simple extraction, and short Q&A at a fraction of the cost. Sonnet covers most complex workflows. Opus is justified for nuanced reasoning and long-form drafting where quality genuinely matters.

API + UI Structural
✂️

Context Trimming

Conversation history grows with every turn. In long sessions, early exchanges often add noise rather than signal. Periodically summarize the conversation state and restart with a condensed context rather than sending the full thread each time.

Workflow
📌

Targeted System Prompts

Bloated system prompts, the ones that try to cover every possible scenario, inflate input tokens on every call. Keep system prompts focused on the specific task. Put rarely-needed instructions in user messages or skill files loaded on demand.

Prompt Design
📉

Output Length Control

Claude defaults to verbose responses unless told otherwise. Explicit instructions like "respond in under 150 words", "use a single sentence", or "no explanation, just the JSON" cut output tokens substantially on extraction and classification tasks.

Prompt Design Easy Win
🔌

Batch API

For high-volume, non-real-time tasks (classification runs, document processing pipelines), Anthropic's Batch API processes requests asynchronously at a discount to synchronous calls, with results returned within a stated window rather than immediately. Check the current discount and turnaround on the pricing page.

API Only Discounted

Token Reduction Cheat Sheet

── Input Token Reduction ────────────────────────────────── Prompt caching → Cache static system prompts / documents Cache hits are billed at a reduced rate; see pricing page Trim conversation → Summarize history every ~10 turns Prevents context from compounding Scope your context → Only include files/data Claude needs In Claude Code: name the files and folders in the request ── Output Token Reduction ──────────────────────────────── Max tokens param → Set max_tokens to what you actually need Format constraints → "Return only JSON, no explanation" Explicit length → "Answer in one paragraph" ── Model Selection ─────────────────────────────────────── Haiku → Classification, extraction, simple Q&A Sonnet → Analysis, coding, multi-step workflows Opus → Complex reasoning, long-form, high stakes

Getting a team to level 6 or 7?

This page is reference material. The service behind it is training: we train the people who write the CLAUDE.md files and Skills, and configure agents on the platforms a team already uses. We build no pipelines or software.

Visit mai4consulting.com