codebase-maintenance

Analyze branch code changes and update drifted Obsidian vault skill references.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/HelloWorldSungin/ark-skills --skill codebase-maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-maintenance
Source: https://github.com/HelloWorldSungin/ark-skills/tree/main/skills/codebase-maintenance
Command: npx skills add https://github.com/HelloWorldSungin/ark-skills --skill codebase-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It coordinates end-to-end maintenance tasks to keep code, Obsidian vault documentation, and Claude Code skills in sync, reducing drift and wasted effort.

Core Features & Use Cases

  • Synchronize code cleanup with vault documentation health checks to surface stale notes and missing docs.
  • Audit and heal skill references by updating drifted paths, configs, and references across project skills.
  • Generate actionable plans and perform changes with planning-mode safeguards for destructive actions.

Quick Start

Specify a scope (code, vault, skills, or full) to begin the maintenance workflow.

Frequently Asked Questions about codebase-maintenance

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

FAQPage Schema
How do I sync Obsidian vault documentation with code changes on a branch?

You can sync Obsidian vault documentation with code changes by analyzing your current branch, mapping the code modifications to existing vault notes, and updating drifted references to keep both layers aligned. This prevents documentation from becoming stale during development.

What is skill drift detection and how does it heal outdated skill references?

Skill drift detection identifies outdated paths, configurations, and references across project skills. It heals these references by auditing the drifted configurations and updating them to match the current project state, reducing wasted effort and misalignment.

How do I clean up code and check vault documentation health at the same time?

You can clean up code and check vault documentation health simultaneously by specifying a full maintenance scope. This coordinates code cleanup with vault health checks to surface stale notes and missing docs in a single workflow.

Do I need external dependencies to run vault and skill maintenance tasks?

No external dependencies are required for standard runs. The maintenance workflow operates across code cleanup, vault documentation, and skill synchronization natively without needing extra packages or tools installed.

What is the best way to safeguard against destructive actions during codebase maintenance?

The best way to safeguard against destructive actions is to use planning-mode. This generates an actionable plan first and performs changes with built-in safeguards, ensuring you can review modifications before they are applied.

Can I run maintenance on only my Obsidian vault without auditing code?

Yes, you can target only the vault by specifying vault as your scope. This limits the workflow to documentation health checks and note synchronization without running code cleanup or skill audits.