菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Autonomous AI coding loop (Ralph Wiggum methodology). Use when running AI agents in unattended/autonomous mode to independently select and complete tasks from a structured task list (prd.json). Enables AFK development across multiple context windows.
Agent Skill creation workflow. Use when creating new reusable AI agent skills, scaffolding skill directories, or converting existing guides into the portable Agent Skills standard format.
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar tasks.
Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
| name | sync-claude-md |
| description | 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. |
| license | MIT |
| metadata | {"author":"samuel","version":"1.0","category":"workflow"} |
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.
# 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
The command reports what happened for each directory:
After syncing, review generated files and add folder-specific instructions:
samuel sync won't overwrite your changes next time — remove it to protect the file from future updates| 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 |
| 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 |
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
After running sync, verify the results: