skills.rest
tmalcolm-0607
tmalcolm-0607COMMUNITY
Explore all skills by this author →
WebsiteGitHub

claude-md-refresh

Scan CLAUDE.md files and generate validated compliance updates.

Updated May 7, 2026
Search Tags:#best-practices#claude-md#ai-workflow#documentation-update#deprecated-patterns#code-governance#config-lint
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill claude-md-refresh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-refresh
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/claude-md-refresh
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill claude-md-refresh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Outdated CLAUDE.md files with deprecated tool references, missing standard sections, and stale patterns cause broken AI workflows, inconsistent team practices, and missed optimizations for Claude Code and similar AI development tools.

Core Features & Use Cases

  • Automated Gap Detection: Scans all project CLAUDE.md files to identify outdated patterns (e.g., deprecated tool names, old model versions), missing required sections, and broken references.
  • Evidence-Based Proposals: Generates prioritized change proposals (P1-P4) with confidence scores, citing official Anthropic documentation and community best practices as sources.
  • Validated Updates: Applies approved changes with automatic backups, runs config-lint validation before and after updates, and supports dry-run previews and critical fix auto-approval.
  • Use Case: A development team can use this skill to automatically update all CLAUDE.md files in their repository, replacing deprecated FileSearch references with Grep, adding missing Context Management sections, and ensuring full compliance with 2026 Anthropic best practices in minutes.

Quick Start

Use the claude-md-refresh skill to audit and update all CLAUDE.md files in your current project to match 2026 best practices, with automatic validation to ensure no broken references are introduced.

Frequently Asked Questions about claude-md-refresh

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

FAQPage Schema
How do I update outdated CLAUDE.md files to match current AI coding best practices?▼

To update outdated CLAUDE.md files, scan your project to detect deprecated tool references and missing standard sections, generating prioritized change proposals based on 2026 Anthropic official documentation to ensure AI-assisted workflow compliance.

What happens when a CLAUDE.md file references deprecated tools and stale patterns?▼

Deprecated tools and stale patterns in CLAUDE.md files cause broken AI workflows and inconsistent team practices. Automated gap detection identifies these outdated references and missing sections, proposing validated updates to restore compliance.

Can I preview changes before applying updates to my CLAUDE.md configuration?▼

You can preview CLAUDE.md updates using dry-run previews. The process generates prioritized, evidence-based change proposals with confidence scores and supports critical fix auto-approval after running config-lint validation.

How do I ensure validated updates for CLAUDE.md files without introducing broken references?▼

Ensure validated CLAUDE.md updates by running config-lint validation before and after applying changes. The process creates automatic backups and uses evidence-based proposals to prevent broken references and deprecated patterns.

Does this automated gap detection work for any project using Claude Code?▼

Automated gap detection works for any project using Claude Code or similar AI coding tools. It scans all project CLAUDE.md files to identify missing required sections and outdated patterns against community best practices.

What are the limitations of relying on manual updates for AI workflow documentation?▼

Manual updates to AI workflow documentation risk missing deprecated tool names and stale patterns. Automated scanning eliminates these gaps by citing official documentation and validating updates via config-lint to ensure complete compliance.

Related Skills

Explore More Software Engineering Skills→
pradeepmoulipradeepmouli
2

speckit-baseline

Generate baseline-spec.md and current-state.md from repository analysis.

Community
Advanced
archyl-comarchyl-com
1

archyl-autofix

Detect Archyl C4 model drift and generate auto-fix proposals via Change Requests.

Official
Advanced
QventuQventu

mintlify

Creates and maintains Mintlify documentation sites using CLI, MDX frontmatter, and docs.json.

Official
Intermediate
Brite-NitesBrite-Nites

best-practices-audit

Audit CLAUDE.md against Anthropic best practices and apply structural auto-fixes.

Official
Advanced