writing-claude-md-files

Generate and maintain CLAUDE.md files for projects and subdirectories.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TK-Evans01/tk-harness --skill writing-claude-md-files-tk-evans01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-claude-md-files
Source: https://github.com/TK-Evans01/tk-harness/tree/main/plugins/tk-rpie/skills/writing-claude-md-files
Command: npx skills add https://github.com/TK-Evans01/tk-harness --skill writing-claude-md-files-tk-evans01

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of efficiently creating and updating CLAUDE.md files, which are crucial for maintaining architectural intent and contracts within a project.

Core Features & Use Cases

  • Project-Level CLAUDE.md: Generates a top-level CLAUDE.md file for project-wide tech stack, commands, and conventions.
  • Domain-Level CLAUDE.md: Creates domain-specific CLAUDE.md files focusing on purpose, contracts, and dependencies.
  • Automatic Date Verification: Ensures the "Last verified" date is accurate and reflects the most recent update.
  • File Hierarchy Management: Organizes CLAUDE.md files according to project structure, including top-level and subdirectory files.

Quick Start

Use the writing-claude-md-files skill to generate a new top-level CLAUDE.md file for your project.

Frequently Asked Questions about writing-claude-md-files

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

FAQPage Schema
How do I generate a CLAUDE.md file for my project?

Generate a CLAUDE.md file by automating its creation to capture project-wide tech stack, commands, and conventions. This ensures architectural intent and contracts are maintained across the repository structure.

What is the difference between project-level and domain-specific CLAUDE.md files?

Project-level CLAUDE.md files document global tech stack and conventions, while domain-specific CLAUDE.md files focus on subdirectory purpose, contracts, and dependencies. This hierarchy organizes documentation according to project structure.

How do I maintain accurate 'Last verified' dates in CLAUDE.md files?

Maintain accurate 'Last verified' dates in CLAUDE.md files using automatic date verification. This ensures the timestamp reflects the most recent update during file maintenance.

Do I need to understand my project structure to create CLAUDE.md files?

You need knowledge of project structure and domain dependencies to create CLAUDE.md files. This prerequisite ensures the generated documentation correctly reflects architectural intent and codebase organization.

What's the best way to document architectural contracts across subdirectories?

The best way to document architectural contracts is by generating domain-specific CLAUDE.md files for subdirectories. This approach captures purpose, contracts, and dependencies while maintaining file hierarchy management.