refresh-skills

Audit and update SKILL.md files to align with the current codebase.

46|5|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/victoriacity/openakari --skill refresh-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-skills
Source: https://github.com/victoriacity/openakari/tree/main/.claude/skills/refresh-skills
Command: npx skills add https://github.com/victoriacity/openakari --skill refresh-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typescript, and includes scripts (resource) components.

What problem does it solve?

Ensures that the AI's understanding of available skills (defined in SKILL.md files) remains accurate and up-to-date with the actual codebase, preventing errors and improving AI performance.

Core Features & Use Cases

  • Drift Detection: Identifies discrepancies between skill descriptions/references and current source code.
  • Description Compliance: Audits skill descriptions for adherence to best practices (triggering conditions vs. summaries).
  • Content Synchronization: Updates stale references, missing coverage, and dead links within skills.
  • Provenance Tracking: Analyzes the origin and necessity of rules within skills for potential simplification or removal.
  • Use Case: After a major refactor of the codebase, run this skill to automatically audit and update all SKILL.md files to reflect the new code structure and functionality, ensuring the AI can still correctly invoke them.

Quick Start

Run the refresh-skills skill to audit and update all skills.

Frequently Asked Questions about refresh-skills

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

FAQPage Schema
How do I keep AI skills aligned with my codebase after a major refactor?

To keep AI skills aligned with your codebase after a refactor, audit `SKILL.md` files to detect content drift and update stale references. This cross-references skill descriptions against current source code to correct discrepancies and ensure accurate AI invocation.

What is content drift in AI skill documentation?

Content drift in AI skill documentation occurs when `SKILL.md` files become outdated relative to the current source code. It manifests as stale references, missing coverage, and dead links that cause the AI to misunderstand available codebase functionality.

How do I audit SKILL.md files for description compliance?

To audit `SKILL.md` files for description compliance, analyze skill descriptions to ensure they adhere to best practices, distinguishing between triggering conditions and summaries. This process also tracks rule provenance to identify unnecessary or simplifiable instructions.

Can I automatically update SKILL.md files to reflect new code structure?

Yes, you can automatically update `SKILL.md` files to reflect a new code structure by running an audit skill. It detects structural gaps, missing coverage, and dead links, then applies necessary fixes to synchronize documentation with the current codebase.

Does refresh-skills require a TypeScript environment?

Yes, refresh-skills requires a TypeScript environment as a dependency. You need TypeScript installed to run the scripts that audit and update `SKILL.md` files against your current codebase.

When should I run an AI skill maintenance audit on my codebase?

You should run an AI skill maintenance audit when you detect errors in AI performance or after major codebase changes. It identifies structural gaps and provenance issues, ensuring your `SKILL.md` files remain synchronized with the actual source code.