From 945f3f986078a326014369230773fde3fc8f0b94 Mon Sep 17 00:00:00 2001 From: kamranahmedse <4921183+kamranahmedse@users.noreply.github.com> Date: Mon, 16 Feb 2026 14:36:31 +0000 Subject: [PATCH 1/4] chore: sync content to repo --- .../content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md | 7 +------ .../content/claudemd@TCWd5vobMAhP7I97Q1rTq.md | 2 +- .../content/compact@65s0P7d39fFR2yhy4JKEZ.md | 2 +- .../content/creating-skills@6WsAQV_e_2XJKl2KlN2dl.md | 2 +- .../content/introduction@RqfeqVMhTSdC4w4GcsETP.md | 2 +- .../content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md | 8 +------- .../skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md | 11 +---------- .../content/skills@OJIfG7DRO4jgQEcberkNx.md | 2 +- .../content/skills@iVa6piQwdPHIDkSRX8OSy.md | 2 +- .../use-subagents-and-hooks@-P9o-aiDM7CDtLimppkjM.md | 4 ++-- 10 files changed, 11 insertions(+), 31 deletions(-) diff --git a/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md b/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md index 36bddf03c647..f5884b5a803d 100644 --- a/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md +++ b/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md @@ -1,8 +1,3 @@ # claude --add-dir -The `claude --add-dir` command is a startup flag that allows you to include extra folders in your working session before the interface even opens. By providing one or more directory paths when you launch the tool (for example, `claude --add-dir ../library --add-dir ./docs`), you grant the assistant permission to read and modify files in those external locations alongside your current project. This is particularly useful for cross-repository tasks, such as updating a shared library and its dependent application simultaneously, as it ensures the AI has a unified view of all relevant codebases from the very first prompt. - -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) \ No newline at end of file +The `claude --add-dir` command is a startup flag that allows you to include extra folders in your working session before the interface even opens. By providing one or more directory paths when you launch the tool (for example, `claude --add-dir ../library --add-dir ./docs`), you grant the assistant permission to read and modify files in those external locations alongside your current project. This is particularly useful for cross-repository tasks, such as updating a shared library and its dependent application simultaneously, as it ensures the AI has a unified view of all relevant codebases from the very first prompt. \ No newline at end of file diff --git a/src/data/roadmaps/claude-code/content/claudemd@TCWd5vobMAhP7I97Q1rTq.md b/src/data/roadmaps/claude-code/content/claudemd@TCWd5vobMAhP7I97Q1rTq.md index 9739e48de240..060c9d10db73 100644 --- a/src/data/roadmaps/claude-code/content/claudemd@TCWd5vobMAhP7I97Q1rTq.md +++ b/src/data/roadmaps/claude-code/content/claudemd@TCWd5vobMAhP7I97Q1rTq.md @@ -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: diff --git a/src/data/roadmaps/claude-code/content/compact@65s0P7d39fFR2yhy4JKEZ.md b/src/data/roadmaps/claude-code/content/compact@65s0P7d39fFR2yhy4JKEZ.md index c406dcd690e3..5570dd2dfcf1 100644 --- a/src/data/roadmaps/claude-code/content/compact@65s0P7d39fFR2yhy4JKEZ.md +++ b/src/data/roadmaps/claude-code/content/compact@65s0P7d39fFR2yhy4JKEZ.md @@ -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) \ No newline at end of file diff --git a/src/data/roadmaps/claude-code/content/creating-skills@6WsAQV_e_2XJKl2KlN2dl.md b/src/data/roadmaps/claude-code/content/creating-skills@6WsAQV_e_2XJKl2KlN2dl.md index fc93c92fa1b5..5787a3ed57fe 100644 --- a/src/data/roadmaps/claude-code/content/creating-skills@6WsAQV_e_2XJKl2KlN2dl.md +++ b/src/data/roadmaps/claude-code/content/creating-skills@6WsAQV_e_2XJKl2KlN2dl.md @@ -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) \ No newline at end of file diff --git a/src/data/roadmaps/claude-code/content/introduction@RqfeqVMhTSdC4w4GcsETP.md b/src/data/roadmaps/claude-code/content/introduction@RqfeqVMhTSdC4w4GcsETP.md index 77d485c00f4a..1e1a65a02a5f 100644 --- a/src/data/roadmaps/claude-code/content/introduction@RqfeqVMhTSdC4w4GcsETP.md +++ b/src/data/roadmaps/claude-code/content/introduction@RqfeqVMhTSdC4w4GcsETP.md @@ -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) diff --git a/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md b/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md index 0abe94256418..57953be40153 100644 --- a/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md +++ b/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md @@ -1,9 +1,3 @@ # 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. - -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) \ No newline at end of file +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. \ No newline at end of file diff --git a/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md b/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md index d763ccd90f06..7aaae4cfa5d2 100644 --- a/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md +++ b/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md @@ -1,12 +1,3 @@ # 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. - -Visit the following resources to learn more: - -- [@official@Create skills](https://code.claude.com/docs/en/best-practices#create-skills) -- [@official@Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) -- [@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) \ No newline at end of file +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. \ No newline at end of file diff --git a/src/data/roadmaps/claude-code/content/skills@OJIfG7DRO4jgQEcberkNx.md b/src/data/roadmaps/claude-code/content/skills@OJIfG7DRO4jgQEcberkNx.md index ef25319bf559..62f49c576272 100644 --- a/src/data/roadmaps/claude-code/content/skills@OJIfG7DRO4jgQEcberkNx.md +++ b/src/data/roadmaps/claude-code/content/skills@OJIfG7DRO4jgQEcberkNx.md @@ -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) diff --git a/src/data/roadmaps/claude-code/content/skills@iVa6piQwdPHIDkSRX8OSy.md b/src/data/roadmaps/claude-code/content/skills@iVa6piQwdPHIDkSRX8OSy.md index bb894b7dbbb5..47e00760a1ea 100644 --- a/src/data/roadmaps/claude-code/content/skills@iVa6piQwdPHIDkSRX8OSy.md +++ b/src/data/roadmaps/claude-code/content/skills@iVa6piQwdPHIDkSRX8OSy.md @@ -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) \ No newline at end of file diff --git a/src/data/roadmaps/claude-code/content/use-subagents-and-hooks@-P9o-aiDM7CDtLimppkjM.md b/src/data/roadmaps/claude-code/content/use-subagents-and-hooks@-P9o-aiDM7CDtLimppkjM.md index ff236a3e2160..c304dcc016b0 100644 --- a/src/data/roadmaps/claude-code/content/use-subagents-and-hooks@-P9o-aiDM7CDtLimppkjM.md +++ b/src/data/roadmaps/claude-code/content/use-subagents-and-hooks@-P9o-aiDM7CDtLimppkjM.md @@ -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) \ No newline at end of file +- [@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) \ No newline at end of file From 212168cc9b0f7e14bdf6a5e3726ca239ab897db9 Mon Sep 17 00:00:00 2001 From: Javier Canales <56018501+jcanalesluna@users.noreply.github.com> Date: Mon, 16 Feb 2026 17:39:12 +0100 Subject: [PATCH 2/4] Update claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md --- .../content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md b/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md index f5884b5a803d..51164fbb2a87 100644 --- a/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md +++ b/src/data/roadmaps/claude-code/content/claude---add-dir@FgQXBQ6oJ5sfW_ar0u6ez.md @@ -1,3 +1,8 @@ # claude --add-dir -The `claude --add-dir` command is a startup flag that allows you to include extra folders in your working session before the interface even opens. By providing one or more directory paths when you launch the tool (for example, `claude --add-dir ../library --add-dir ./docs`), you grant the assistant permission to read and modify files in those external locations alongside your current project. This is particularly useful for cross-repository tasks, such as updating a shared library and its dependent application simultaneously, as it ensures the AI has a unified view of all relevant codebases from the very first prompt. \ No newline at end of file +The `claude --add-dir` command is a startup flag that allows you to include extra folders in your working session before the interface even opens. By providing one or more directory paths when you launch the tool (for example, `claude --add-dir ../library --add-dir ./docs`), you grant the assistant permission to read and modify files in those external locations alongside your current project. This is particularly useful for cross-repository tasks, such as updating a shared library and its dependent application simultaneously, as it ensures the AI has a unified view of all relevant codebases from the very first prompt. + +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) From 96740a4222ecba058adbd74e7ac9a6058ab1dbf2 Mon Sep 17 00:00:00 2001 From: Javier Canales <56018501+jcanalesluna@users.noreply.github.com> Date: Mon, 16 Feb 2026 17:40:21 +0100 Subject: [PATCH 3/4] Enhance prompt caching documentation with resources Added additional resources for learning about prompt caching. --- .../content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md b/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md index 57953be40153..4da336d5d589 100644 --- a/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md +++ b/src/data/roadmaps/claude-code/content/prompt-caching@Dam_IG339RrYZXjXq3T8_.md @@ -1,3 +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. \ No newline at end of file +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) From 78f45f67d3fb25ec22edd304fb6110aeddfd6af2 Mon Sep 17 00:00:00 2001 From: Javier Canales <56018501+jcanalesluna@users.noreply.github.com> Date: Mon, 16 Feb 2026 17:41:04 +0100 Subject: [PATCH 4/4] Update skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md --- .../skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md b/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md index 7aaae4cfa5d2..f374ba376e30 100644 --- a/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md +++ b/src/data/roadmaps/claude-code/content/skill-best-practices@5uIBv9rk7Wzc_bXny0B27.md @@ -1,3 +1,12 @@ # 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. \ No newline at end of file +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: + +- [@official@Create skills](https://code.claude.com/docs/en/best-practices#create-skills) +- [@official@Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) +- [@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)