sync-claude-md

Generate and update per-folder CLAUDE.md and AGENTS.md files with auto-detected content.

7|1|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/ar4mirez/samuel --skill sync-claude-md-ar4mirez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-claude-md
Source: https://github.com/ar4mirez/samuel/tree/main/template/.claude/skills/sync-claude-md
Command: npx skills add https://github.com/ar4mirez/samuel --skill sync-claude-md-ar4mirez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation and updating of CLAUDE.md and AGENTS.md files within your project's directory structure, ensuring AI agents have accurate, context-aware instructions.

Core Features & Use Cases

  • Automated File Generation: Creates CLAUDE.md and AGENTS.md in project subdirectories.
  • Contextual Awareness: Detects languages, key files, and test indicators to populate these files.
  • Use Case: After adding a new Go module to your project, run samuel sync to automatically generate the necessary CLAUDE.md and AGENTS.md files for that new directory, including detected Go files and test patterns.

Quick Start

Run samuel sync to update all CLAUDE.md and AGENTS.md files in the current project.

Frequently Asked Questions about sync-claude-md

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

FAQPage Schema
How do I automatically generate CLAUDE.md and AGENTS.md files for my project subdirectories?

You can automatically generate CLAUDE.md and AGENTS.md context files by recursively scanning project directories to detect programming languages, key files, and test patterns for AI agents.

How does automated AI context file synchronization work for existing codebases?

AI context file synchronization works by recursively scanning your project directories to identify languages, key files, and test indicators, then populating CLAUDE.md and AGENTS.md files with context-aware instructions for AI agents.

Can I preview changes before updating AI context files in my project?

Yes, you can perform a dry run to preview changes before modifying any files, ensuring the detected languages and test patterns match your project structure before applying updates.

What's the best way to control directory depth when generating AI agent context files?

You can control directory depth during the recursive scan to limit how deep the tool traverses your project folders, ensuring AI context files are only generated at the desired directory levels.

How do I force overwrite existing CLAUDE.md and AGENTS.md files with updated context?

You can use the forceful overwrite option to replace existing CLAUDE.md and AGENTS.md files with freshly generated content, or fall back to manual creation if needed.

Does automated context file generation detect test patterns and programming languages automatically?

Yes, automated context file generation detects programming languages, key files, and test patterns by scanning directory contents to provide accurate, context-aware instructions for AI agents.