skills.rest
ed3dai
ed3daiOFFICIAL
Explore all skills by this author →
GitHub

writing-claude-md-files

Create and maintain CLAUDE.md files with required frontmatter and Last verified dates.

5|1|Updated Jan 26, 2026
Search Tags:#template#architecture#documentation#metadata#claude.md#frontmatter#contracts
One-click install
npx skills add https://github.com/ed3dai/ed3d-plugins-testing --skill writing-claude-md-files
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-claude-md-files
Source: https://github.com/ed3dai/ed3d-plugins-testing/tree/main/plugins/ed3d-extending-claude/skills/writing-claude-md-files
Command: npx skills add https://github.com/ed3dai/ed3d-plugins-testing --skill writing-claude-md-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams create and maintain CLAUDE.md files for projects and subdirectories, ensuring consistent guidance and up-to-date freshness dates.

Core Features & Use Cases

  • Top-level guidance: Create and update CLAUDE.md at the project root to capture tech stack, commands, conventions, and boundaries.
  • Domain-level guidance: Generate CLAUDE.md files for domains that explain WHY the domain exists, its contracts, and dependencies.
  • Freshness enforcement: Include and update a Last verified date to reflect current accuracy, and reference key files/templates.

Quick Start

Start by scaffolding a CLAUDE.md for a new project, then add domain CLAUDE.md files for each subdirectory as you grow.

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 create and maintain CLAUDE.md files across project directories?▼

To create and maintain CLAUDE.md files, automate the scaffolding of top-level project guidance and domain-level subdirectory documentation, ensuring required frontmatter like name, description, and a Last verified date are consistently present.

What should be included in a CLAUDE.md file for project architecture?▼

A CLAUDE.md file should include the tech stack, commands, conventions, and boundaries for top-level projects, while domain-level files must explain why the domain exists, its contracts, dependencies, and reference key templates.

Why does my project documentation need a Last verified date in the metadata?▼

A Last verified date in metadata enforces freshness by reflecting current accuracy, ensuring teams know exactly when the documentation, contracts, and architecture boundaries were last validated against the codebase.

Can I use templates to generate domain-level documentation for subdirectories?▼

Yes, you can generate domain-level documentation for subdirectories by applying recommended templates that define the required frontmatter and structure, guiding what specific contracts and dependencies to include.

What is the best way to keep architecture documentation fresh and consistent?▼

The best way to keep architecture documentation fresh is to automate maintenance updates across all CLAUDE.md files, enforcing required frontmatter and updating the Last verified date whenever domain contracts or dependencies change.

Related Skills

Explore More Content & Communication Skills→
Camilo8902Camilo8902

project-scaffolder

Generates starter projects for Next.js, Vite, Nest, and FastAPI with predefined folder structures and configurations.

Community
Intermediate
cliveportmancliveportman
1

claude-review-criteria

Review .claude/ directory changes for frontmatter correctness and content quality.

Community
Basic
bellugabelluga

wf-flutter-create-domain-method

Scaffold a Flutter domain aggregate with value objects, projections, repository contracts, and DI wiring.

Official
Advanced
mokbhaimokbhai
1

astro-developer

Initialize and deploy Astro projects with Tailwind and islands architecture.

Community
Advanced