claudemd curator

Security Community

Skill notes

MANDATORY ACTIVATION

Use this skill when the user asks for: "audit CLAUDE.md" or "check CLAUDE.md" "improve project memory" or "optimize memory" "sync AGENTS.md" or "Codex AGENTS.md sync" "update .claude/rules" or "review .claude/rules"

FAILURE CONDITIONS

Skipping the claudemd-curator skill entirely leaves project memory in a degraded state, causing: Degraded memory quality: Stale, incomplete, or conflicting instructions in CLAUDE.md, AGENTS.md, .claude.local.md, and .claude/rules/*.md Missed rule updates: Critical commands, patterns, or architecture changes remain undocumented Unsynced cross-tool memory: Claude Code and Codex/Codeium agents diverge when CLAUDE.md and AGENTS.md fall out of sync

Phase 1: Discovery

Find all project-memory artifacts in the repository and known Claude user-memory locations. When the user explicitly asks for multi-repo coverage (e.g., "check all workspaces", "audit workspace memory"), extend discovery to workspace roots configured in WORKSPACE_DIRS environment variable or use default examples. Discovery runs across all matching artifacts with no sampling or truncation. The skill processes the complete list to satisfy the claudemd-curator contract.

Phase 2: Quality Assessment

For each discovered project-memory artifact (CLAUDE.md, AGENTS.md, .claude.local.md, .claude/rules/*.md), evaluate against quality criteria. See references/quality-criteria.md for detailed rubrics. Before final scoring, compare ~/.claude/CLAUDE.md (when present) with every project-level CLAUDE.md. Surface duplicated commands, overlapping standing rules, and conflicting instructions as potential drift. The report must name the global file and each affected project path; do not silently merge or rewrite global content.

Phase 2.5: Plugin Mode

When the repository includes marketplace/plugin metadata, run plugin-aware audit against existing marketplace truth signals instead of producing duplicate drift facts. Consume capability-snapshot output from marketplace-tour when available and cross-reference discovered memory artifacts with METADATA_DRIFT, CONTENT_DRIFT, and STALE_<N>d signals.

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Security
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@tomevault-io · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
macOS · Linux · Windows
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
  • Env read
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview claudemd-curator.preview
# Phase 3: Quality Report Output

**ALWAYS output the quality report BEFORE making any updates.** Format: ```

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.