How do I declare the scope of a new skill?

Every skill should use the YAML frontmatter to explicitly state its scope (e.g., meta-configuration or domain-implementation) and its target (e.g., claude-code-itself or application-feature).

How does the CLAUDE.md hierarchy work?

Precedence follows a specific order: Project-level (most specific) overrides Meta-level, which overrides Global-level (most generic) instructions.

Why do I need to separate meta and domain configurations?

Separation prevents Claude from confusing tool-specific commands (like environment setup) with project-specific functionality (like application deployment), ensuring the AI operates in the correct context.

Is this guide necessary for projects using LangChain or Anthropic SDK?

Yes, it is critical because these SDKs use similar terminology to Claude Code. Without isolation, the AI may fail to distinguish between its own internal tools and the agents you are building.

What is the recommended prefix for Claude Code meta-settings?

The guide recommends using the 'cc-' prefix for all meta-configurations and tools to distinguish them clearly from any application-level code.

Meta-Domain Configuration Isolation

Name: Meta-Domain Configuration Isolation
Author: joaopelegrino

byjoaopelegrino

0•

開発者ツール

Prevents configuration conflicts by isolating Claude Code tool settings from project-specific implementation logic.

This skill provides a comprehensive architectural framework for distinguishing between meta-level configurations (how the AI tool behaves) and domain-level configurations (how the application logic works). By implementing namespace isolation, standardized prefixing conventions, and hierarchical CLAUDE.md structures, it ensures that Claude correctly interprets commands and skills without overlapping contexts. This is particularly vital when developing projects that use agentic SDKs like LangChain or Google ADK, where terminology like 'agent' and 'skill' might otherwise cause functional collisions.

主な機能

01Conflict resolution patterns for ambiguous terminology like 'agent' or 'hook'

02Explicit scope declaration templates for YAML frontmatter in skill files

03Hierarchical CLAUDE.md management across global, meta, and project levels

04Context detection checklists to verify directory and precedence before execution

05Namespace isolation strategies using mandatory cc- prefixes for meta-configurations

060 GitHub stars

ユースケース

01Scaling Claude Code configurations across multiple distinct repositories and environments

02Standardizing team-wide naming conventions for custom AI tools and project commands

03Developing projects using AI SDKs where 'agent' terminology overlaps with Claude Code defaults

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joaopelegrino/claude-code cc-separation-guide

For use in Claude.ai and ChatGPT

Download Skill