refresh-best-practices

Refresh stale Claude Code best practices documentation with confidence-tagged change proposals.

Updated May 7, 2026
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill refresh-best-practices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-best-practices
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/refresh-best-practices
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill refresh-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Outdated Claude Code best practices documentation leads to inconsistent team workflows, missed platform optimizations, and misalignment with official Anthropic recommendations, requiring time-consuming manual research to resolve.

Core Features & Use Cases

  • Automated Staleness Detection: Identifies documentation categories that haven't been updated in over 90 days.
  • Parallel Research: Spawns dedicated agents to research official Anthropic docs and high-quality community repositories for each stale category.
  • Evidence-Based Updates: Generates confidence-tagged change proposals, presents them for user approval, and applies approved changes atomically with full changelog tracking.
  • Use Case: Development teams using Claude Code can run this skill quarterly to ensure internal best practices docs align with the latest official features and proven community patterns, reducing onboarding friction and avoiding outdated workflows.

Quick Start

Use the refresh-best-practices skill to update all stale best practices categories in your internal documentation.

Frequently Asked Questions about refresh-best-practices

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

FAQPage Schema
How do I keep Claude Code best practices documentation up to date with official Anthropic sources?

To keep Claude Code best practices documentation up to date, you can automate the refresh process by researching official Anthropic docs and high-quality community repositories to generate confidence-tagged change proposals for your internal workflow guides.

What is the best way to detect stale internal workflow guides for agent orchestration?

The best way to detect stale internal workflow guides is using automated staleness detection, which identifies documentation categories that haven't been updated in over 90 days and flags them for parallel research and updates.

How does evidence-based change tracking work for team documentation refreshes?

Evidence-based change tracking works by spawning dedicated agents to research sources, generating confidence-tagged change proposals, and applying approved changes atomically with full changelog tracking for auditability and traceability.

Can I automate quarterly alignment of internal skill standards with evolving platform features?

Yes, you can automate quarterly alignment of internal skill standards with evolving platform features by running a documentation refresh skill that targets development teams and ensures governance docs match proven agent orchestration patterns.

Do I need dedicated agents to research community repositories for documentation updates?

You need dedicated agents to research community repositories if you want parallel research across multiple stale categories, which allows the system to gather evidence from high-quality sources efficiently before generating change proposals.