best-practices

Enforce Claude Code development best practices for skills and CLAUDE.md files.

Updated Nov 6, 2025
One-click install
npx skills add https://github.com/toumakido/my-claude --skill best-practices-toumakido
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: best-practices
Source: https://github.com/toumakido/my-claude/tree/main/skills/best-practices
Command: npx skills add https://github.com/toumakido/my-claude --skill best-practices-toumakido

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill codifies Claude Code best practices and automatically enforces them to reduce drift and errors during skill creation, CLAUDE.md editing, context management, and feature implementation.

Core Features & Use Cases

  • Enforces standardized frontmatter (name, description) and line-count constraints.
  • Guides CLAUDE.md governance and best-practice workflows.
  • Validates context isolation guidelines and side-effect safeguards during implementation.
  • Provides a reference framework for skill creation and maintenance.

Quick Start

Use the best-practices skill at the start of any new skill development or CLAUDE.md update to apply the standardized rules.

Frequently Asked Questions about best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce Claude Code best practices for skill creation and CLAUDE.md management?

To enforce Claude Code best practices, you can automatically validate frontmatter presence with name and description, ensure SKILL.md stays under 500 lines, and apply side-effect safeguards like disable-model-invocation during skill creation and CLAUDE.md governance.

What frontmatter is required when creating a Claude Code skill?

Required frontmatter for Claude Code skill creation includes name and description fields. The best practices framework automatically validates their presence to enforce standardization and reduce drift during skill development.

How do I manage CLAUDE.md context and side-effect safeguards during feature implementation?

Managing CLAUDE.md context involves validating context isolation guidelines and side-effect safeguards like disable-model-invocation during feature implementation. The best practices framework applies structured governance workflows to prevent errors.

What is the line limit for a SKILL.md file in Claude Code?

The line limit for a SKILL.md file in Claude Code is 500 lines. The best practices framework automatically enforces this constraint to maintain readability and prevent context overflow during skill maintenance.

When do I need to apply frontmatter validation and context isolation guidelines?

You need to apply frontmatter validation and context isolation guidelines at the start of any new skill development or CLAUDE.md update. This ensures standardized rules and side-effect safeguards are enforced automatically throughout the workflow.

Does Claude Code best practices skill work without external dependencies?

Yes, the Claude Code best practices skill works without external dependencies. It operates as an advanced standalone framework providing structured guidance for skill creation, CLAUDE.md governance, and context handling without requiring additional components.