ar4mirez/sync-claude-md
internal/skills/content/sync-claude-md/SKILL.md
Sync per-folder CLAUDE.md and AGENTS.md files with context-aware content. Use after structural changes, adding new directories, refactoring, or periodic maintenance to keep folder-level AI instructions current.
$ install --global
skillsauthnpx skillsauth add ar4mirez/samuel sync-claude-mdInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 3:54 AM25.2s1 file scanned
SKILL.md
- name:
- sync-claude-md
- description:
- |
- license:
- MIT
- author:
- samuel
- version:
- 1.0
- category:
- workflow
Sync CLAUDE.md Files
Recursively scan project directories and create or update per-folder CLAUDE.md and AGENTS.md files with auto-detected content including languages, purpose, key files, and test indicators.
When to Use
- After creating new directories or packages
- After a major refactoring that moves files between folders
- After adding a new language or framework to the project
- Periodic maintenance to keep folder context accurate
- When onboarding a new project with many existing directories
Process
Step 1: Run Sync
# Sync all directories (recursive, unlimited depth)
samuel sync
# Preview changes first
samuel sync --dry-run
# Only top-level directories
samuel sync --depth 1
# Overwrite user-customized files
samuel sync --force
Step 2: Review Output
The command reports what happened for each directory:
- Created — New CLAUDE.md + AGENTS.md files generated
- Updated — Existing auto-generated files refreshed with current analysis
- Skipped — User-customized files preserved (no auto-gen marker)
Step 3: Customize as Needed
After syncing, review generated files and add folder-specific instructions:
- Open any generated CLAUDE.md
- Add project-specific context below the auto-generated sections
- The auto-gen marker ensures
samuel syncwon't overwrite your changes next time — remove it to protect the file from future updates
What Gets Detected
| Detection | Examples |
|-----------|----------|
| Languages | Go, Python, TypeScript, Rust, Java, etc. (by file extension) |
| Purpose | cmd/ → entry points, internal/ → private packages, tests/ → test files |
| Key files | main.go, package.json, Dockerfile, Makefile |
| Tests | *_test.go, test_*.py, *.spec.ts, *.test.js |
Update Strategy
| Condition | Action |
|-----------|--------|
| File doesn't exist | Create new file |
| File has <!-- Auto-generated by Samuel marker | Update (overwrite) |
| File exists without marker | Skip (user-customized) |
| --force flag | Always overwrite |
Manual Fallback
If the CLI is not available, create per-folder CLAUDE.md files manually:
# folder-name
<!-- Auto-generated by Samuel. Customize with folder-specific instructions. -->
<!-- AI agents load this file when working in this directory. -->
## Purpose
Description of what this folder contains.
## Languages
- Go (10 files)
## Key Files
- `main.go` — Entry point
Post-Sync Verification
After running sync, verify the results:
- Check that generated content matches folder reality
- Ensure no sensitive directories received CLAUDE.md files
- Confirm AGENTS.md mirrors CLAUDE.md in each folder
- Add custom instructions where auto-detected content is insufficient
Related Skills
ar4mirez/zig-guide
development
VerifiedTrustedCommunity
Zig language guardrails, patterns, and best practices for AI-assisted development. Use when working with Zig files (.zig), build.zig, or when the user mentions Zig. Provides comptime patterns, allocator conventions, C interop guidelines, and testing standards specific to this project's coding standards.
8SKILL.mdUpdated Apr 30, 2026
ar4mirez/wordpress
tools
VerifiedTrustedCommunity
WordPress framework guardrails, patterns, and best practices for AI-assisted development. Use when working with WordPress projects, or when the user mentions WordPress. Provides theme development, plugin architecture, REST API, blocks, and security guidelines.
8SKILL.mdUpdated Apr 30, 2026
ar4mirez/webapp-testing
tools
VerifiedTrustedCommunity
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Use when testing web apps, automating browser interactions, or debugging frontend issues.
8SKILL.mdUpdated Apr 30, 2026
ar4mirez/web-artifacts-builder
tools
VerifiedTrustedCommunity
Suite of tools for creating elaborate, multi-component web applications using modern frontend technologies (React, Tailwind CSS, shadcn/ui). Use for complex projects requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX pages.
8SKILL.mdUpdated Apr 30, 2026