project-config

To configure project-level Claude assets, create a .claude/ directory at the repository root and add skill, agent, command, and rule definitions with required frontmatter. This standardizes the directory layout and enables consistent loading across CLAUDE.md.

Claude skills and commands require name and description frontmatter in their SKILL.md files. Enforcing these frontmatter requirements prevents misplacement and loading conflicts when Claude Code initializes the project configuration.

CLAUDE.md inheritance works by loading configurations and rules from the .claude/ directory structure. Properly organizing rules under .claude/ ensures consistent inheritance and prevents conflicts across the project repository.

The correct directory layout for Claude project configuration places skills, agents, commands, and rules under a .claude/ directory at the project root. This structure enforces naming rules and prevents configuration misplacement.

Claude project rules fail to load correctly when directory structure conventions are violated or frontmatter is missing. Validating the .claude/ layout and ensuring required name and description fields exist prevents these loading conflicts.

Yes, you can add a new skill to an existing .claude/ configuration by creating a SKILL.md file with proper name and description frontmatter. This integrates the skill with CLAUDE.md inheritance and existing project rules.