Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ The `claude --add-dir` command is a startup flag that allows you to include extr
Visit the following resources to learn more:

- [@official@CLI flags](https://code.claude.com/docs/en/cli-reference#cli-flags)
- [@official@Load memory from additional directories](https://code.claude.com/docs/en/memory#load-memory-from-additional-directories)
- [@official@Load memory from additional directories](https://code.claude.com/docs/en/memory#load-memory-from-additional-directories)
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# CLAUDE.md

[CLAUDE.md](http://CLAUDE.md) is a project-specific markdown file that acts as the "persistent memory" and onboarding manual for Claude Code, ensuring the AI adheres to your unique development standards across every session. Since Claude begins each new interaction with a blank context, this file is automatically read at launch to provide essential project "WHY, WHAT, and HOW"—including your tech stack, directory structure, preferred coding patterns (e.g., "Use functional React components"), and exact shell commands for building or testing. By maintaining this document in your project root or `.claude/` directory, you eliminate the need to repeat basic instructions in your prompts, significantly reduce "hallucinations" or stylistic drift, and keep the AI aligned with your team's specific conventions. You can quickly bootstrap a custom version by running the `/init` command, which analyzes your repository to detect frameworks and suggest a baseline configuration.
CLAUDE.md is a project-specific markdown file that acts as the "persistent memory" and onboarding manual for Claude Code, ensuring the AI adheres to your unique development standards across every session. Since Claude begins each new interaction with a blank context, this file is automatically read at launch to provide essential project "WHY, WHAT, and HOW"—including your tech stack, directory structure, preferred coding patterns (e.g., "Use functional React components"), and exact shell commands for building or testing. By maintaining this document in your project root or `.claude/` directory, you eliminate the need to repeat basic instructions in your prompts, significantly reduce "hallucinations" or stylistic drift, and keep the AI aligned with your team's specific conventions. You can quickly bootstrap a custom version by running the `/init` command, which analyzes your repository to detect frameworks and suggest a baseline configuration.

Visit the following resources to learn more:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,5 @@ The `/compact` command is a context management tool designed to optimize your se
Visit the following resources to learn more:

- [@official@Built-in commands](https://code.claude.com/docs/en/interactive-mode)
- [@article@What Actually Happens When You Run `/compact` in Claude Code](https://dev.to/rigby_/what-actually-happens-when-you-run-compact-in-claude-code-3kl9)
- [@article@What Actually Happens When You Run /compact in Claude Code](https://dev.to/rigby_/what-actually-happens-when-you-run-compact-in-claude-code-3kl9)
- [@video@3 Ways to Fix Claude Code's Context](https://www.youtube.com/watch?v=yBLwsBKPYSw)
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ To create a custom skill in Claude Code, you must establish a new folder within

Visit the following resources to learn more:

- [@course@Agent Skills with Anthropic](https://www.deeplearning.ai/short-courses/agent-skills-with-anthropic/)
- [@official@Extend Claude with skills](https://code.claude.com/docs/en/skills#extend-claude-with-skills)
- [@official@How to create custom Skills](https://support.claude.com/en/articles/12512198-how-to-create-custom-skills)
- [@course@Agent Skills with Anthropic](https://www.deeplearning.ai/short-courses/agent-skills-with-anthropic/)
- [@article@Claude Code Skills — Equipping Your Claude Code Agents with more Superpowers](https://medium.com/@ooi_yee_fei/claude-code-skills-superpowering-claude-code-agents-a42b44a58ae2)
- [@article@Build Your First Claude Code Agent Skill: A Simple Project Memory System That Saves Hours](https://pub.spillwave.com/build-your-first-claude-code-skill-a-simple-project-memory-system-that-saves-hours-1d13f21aff9e)
- [@video@Claude Code Skills & skills.sh - Crash Course](https://www.youtube.com/watch?v=rcRS8-7OgBo)
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ Claude Code is an AI-powered coding tool developed by Anthropic that operates di

Visit the following resources to learn more:

- [@course@Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action)
- [@official@Claude Code overview](https://code.claude.com/docs/en/overview)
- [@official@How Claude Code works](https://code.claude.com/docs/en/how-claude-code-works)
- [@course@Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action)
- [@article@What is Claude Code? The AI coding tool anyone can use](https://zapier.com/blog/claude-code/)
- [@article@Claude Code: A Guide With Practical Examples](https://www.datacamp.com/tutorial/claude-code)
- [@video@Claude Code Tutorial for Beginners](https://www.youtube.com/watch?v=eMZmDH3T2bY)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Prompt Caching

Prompt caching in Claude Code is a performance-optimizing feature that stores the frequently used "prefixes" of your conversations—such as your entire codebase state, system instructions, and tool definitions—so they don't have to be reprocessed from scratch with every new message. In an agentic environment where Claude often re-reads your files multiple times to maintain context, caching acts as a "checkpoint" system: while the initial write to the cache carries a slight premium, every subsequent interaction that reuses that prefix receives a 90% discount on input tokens and up to an 85% reduction in latency. Claude Code handles this automatically by placing "cache breakpoints" at strategic points in the prompt (like after your [CLAUDE.md](http://CLAUDE.md) and project structure), ensuring that even as your conversation grows, the "static" foundation of your project remains instantly accessible and cost-effective.
Prompt caching in Claude Code is a performance-optimizing feature that stores the frequently used "prefixes" of your conversations—such as your entire codebase state, system instructions, and tool definitions—so they don't have to be reprocessed from scratch with every new message. In an agentic environment where Claude often re-reads your files multiple times to maintain context, caching acts as a "checkpoint" system: while the initial write to the cache carries a slight premium, every subsequent interaction that reuses that prefix receives a 90% discount on input tokens and up to an 85% reduction in latency. Claude Code handles this automatically by placing "cache breakpoints" at strategic points in the prompt (like after your CLAUDE.md and project structure), ensuring that even as your conversation grows, the "static" foundation of your project remains instantly accessible and cost-effective.

Visit the following resources to learn more:

- [@official@Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
- [@official@Prompt caching configuration](https://code.claude.com/docs/en/model-config#prompt-caching-configuration)
- [@article@Unlocking Efficiency: A Practical Guide to Claude Prompt Caching](https://medium.com/@mcraddock/unlocking-efficiency-a-practical-guide-to-claude-prompt-caching-3185805c0eef)
- [@article@Unlocking Efficiency: A Practical Guide to Claude Prompt Caching](https://medium.com/@mcraddock/unlocking-efficiency-a-practical-guide-to-claude-prompt-caching-3185805c0eef)
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Skill Best Practices

When configuring Claude Code skills, the primary best practice is to optimize for discoverability and context efficiency by using precise YAML frontmatter and "lazy loading." Your skill's `description` should act as a clear semantic trigger, using specific keywords that help Claude identify exactly when to activate the expert instructions without bloating the context window of every conversation. Structure the `SKILL.md` with a narrow, modular focus rather than creating a "Swiss Army Knife" skill; if a workflow has non-negotiable side effects, use `disable-model-invocation: true` to ensure it only runs when manually triggered via a slash command. Additionally, leverage argument placeholders (like `$ARGUMENTS`) to make your skills reusable across different files, and store them in the project’s `.claude/skills/` directory so they are version-controlled and shared with your team. Finally, keep skill instructions deterministic by providing step-by-step tool sequences, which ensures Claude follows your project’s "golden path" for complex tasks like deployments or security audits.
When configuring Claude Code skills, the primary best practice is to optimize for discoverability and context efficiency by using precise YAML frontmatter and "lazy loading." Your skill's `description` should act as a clear semantic trigger, using specific keywords that help Claude identify exactly when to activate the expert instructions without bloating the context window of every conversation. Structure the `SKILL.md` with a narrow, modular focus rather than creating a "Swiss Army Knife" skill; if a workflow has non-negotiable side effects, use `disable-model-invocation: true` to ensure it only runs when manually triggered via a slash command. Additionally, leverage argument placeholders (like `$ARGUMENTS`) to make your skills reusable across different files, and store them in the project’s `.claude/skills/` directory so they are version-controlled and shared with your team. Finally, keep skill instructions deterministic by providing step-by-step tool sequences, which ensure Claude follows your project’s "golden path" for complex tasks like deployments or security audits.

Visit the following resources to learn more:

Expand All @@ -9,4 +9,4 @@ Visit the following resources to learn more:
- [@official@The Complete Guide to Building Skills for Claude](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?hsLang=en)
- [@article@A useful cheatsheet for understanding Claude Skills](https://www.reddit.com/r/ClaudeAI/comments/1qbpe91/a_useful_cheatsheet_for_understanding_claude/)
- [@article@Writing Claude Skills That Actually Work: A Guide to What Works (And What Doesn’t)](https://medium.com/@creativeaininja/writing-claude-skills-that-actually-work-a-guide-to-what-works-and-what-doesnt-2dfcd9593106)
- [@video@Claude Code Skills are INSANE (and you’re not using them correctly)](https://www.youtube.com/watch?v=thxXGxYIwUI)
- [@video@Claude Code Skills are INSANE (and you’re not using them correctly)](https://www.youtube.com/watch?v=thxXGxYIwUI)
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ In Claude Code, Skills are self-contained folders of "expert knowledge" and repe

Visit the following resources to learn more:

- [@course@Agent Skills with Anthropic](https://www.deeplearning.ai/short-courses/agent-skills-with-anthropic/)
- [@official@Extend Claude with skills](https://code.claude.com/docs/en/skills#extend-claude-with-skills)
- [@official@The Complete Guide to Building Skills for Claude](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?hsLang=en)
- [@opensource@skill](https://github.com/anthropics/skills)
- [@course@Agent Skills with Anthropic](https://www.deeplearning.ai/short-courses/agent-skills-with-anthropic/)
- [@article@Claude Code Skills — Equipping Your Claude Code Agents with more Superpowers](https://medium.com/@ooi_yee_fei/claude-code-skills-superpowering-claude-code-agents-a42b44a58ae2)
- [@video@Claude Code Skills & skills.sh - Crash Course](https://www.youtube.com/watch?v=rcRS8-7OgBo)
- [@video@Stop Using Claude Code Without Skills](https://www.youtube.com/watch?v=vIUJ4Hd7be0)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ Claude Code skills are modular packages of instructions, scripts, and assets tha

Visit the following resources to learn more:

- [@course@Agent Skills with Anthropic](https://www.deeplearning.ai/short-courses/agent-skills-with-anthropic/)
- [@official@Extend Claude with skills](https://code.claude.com/docs/en/skills)
- [@official@The Complete Guide to Building Skills for Claude](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?hsLang=en)
- [@opensource@skills](https://github.com/anthropics/skills)
- [@course@Agent Skills with Anthropic](https://www.deeplearning.ai/short-courses/agent-skills-with-anthropic/)
- [@article@Inside Claude Skills: Custom Modules That Extend Claude](https://www.datacamp.com/tutorial/claude-skills)
- [@video@Claude Code Skills & skills.sh - Crash Course](https://www.youtube.com/watch?v=rcRS8-7OgBo)
- [@video@Claude Code Skills are INSANE (and you’re not using them correctly) - YouTube](https://www.youtube.com/watch?v=thxXGxYIwUI)
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,5 @@ In Claude Code, Subagents and Hooks are powerful architectural tools that manage
Visit the following resources to learn more:

- [@official@Claude Code Subagents: Complete Guide to Multi-Agent Architecture](https://wmedia.es/en/writing/claude-code-subagents-guide-ai)
- [@article@Delegate verbose operations to subagents](https://code.claude.com/docs/en/costs#delegate-verbose-operations-to-subagents)
- [@official@Automate workflows with hooks](https://code.claude.com/docs/en/hooks-guide)
- [@official@Automate workflows with hooks](https://code.claude.com/docs/en/hooks-guide)
- [@article@Delegate verbose operations to subagents](https://code.claude.com/docs/en/costs#delegate-verbose-operations-to-subagents)