skills.rest
yoshisada
yoshisadaCOMMUNITY
Explore all skills by this author →
GitHub

shelf-repair

Re-apply the current dashboard template to existing Obsidian projects.

Updated Mar 26, 2026
Search Tags:#template#dashboard#obsidian#diff#repair#shelf
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill shelf-repair
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shelf-repair
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-shelf/skills/shelf-repair
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill shelf-repair

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Re-apply the current dashboard template to an existing Obsidian project, preserving user content and normalizing status labels while producing a diff preview of changes.

Core Features & Use Cases

  • Reapply the canonical dashboard template to an existing Obsidian vault without data loss.
  • Generate a diff report before applying changes and normalize non-canonical status labels to canonical equivalents.
  • Validate project identity via .shelf-config and restore consistency across dashboards in multiple projects.

Quick Start

Run shelf:shelf-repair to re-apply the current dashboard template to your Obsidian project and review the diff before applying changes.

Frequently Asked Questions about shelf-repair

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

FAQPage Schema
How do I reapply a dashboard template to an Obsidian vault without losing existing content?▼

To repair an Obsidian dashboard without data loss, reapply the current template to existing projects. The shelf-repair process generates a diff preview first, ensuring user content is preserved while normalizing status labels.

What is diff-based dashboard repair in Obsidian?▼

Diff-based dashboard repair re-applies a canonical template to existing Obsidian projects while generating a comparison report. This mechanism highlights required structural updates and normalizes non-canonical status labels before any changes are applied.

How do I normalize non-canonical status labels across multiple Obsidian dashboards?▼

Normalize non-canonical status labels by re-applying the current dashboard template to your Obsidian projects. The repair process restores consistency by converting variant labels to their canonical equivalents and validating project identity.

Do I need a .shelf-config file to repair Obsidian dashboards?▼

Yes, dashboard repair requires a .shelf-config file in your Obsidian vault. This configuration validates project identity, reads the current template, and generates the diff needed to apply safe repairs across multiple projects.

Can I preview changes before applying template repairs to Obsidian dashboards?▼

Yes, you can preview changes before repairing Obsidian dashboards. The process generates a diff report detailing all structural updates and status label normalizations, allowing you to verify changes before safely applying them.

What happens if my Obsidian vault has inconsistent dashboard structures across projects?▼

Inconsistent Obsidian dashboard structures are repaired by re-applying the canonical template to each project. The process validates identity via .shelf-config, generates a diff of required updates, and restores structural consistency safely.

Related Skills

Explore More Software Engineering Skills→
yoshisadayoshisada

shelf-feedback

Read Obsidian dashboard feedback, suggest actions, and archive items with timestamps.

Community
Intermediate
apokamoapokamo
12

issue-verify-code

Verify code fixes against prior feedback and git diff HEAD~1.

Community
Intermediate
yoshisadayoshisada

shelf-sync

Synchronize GitHub issues, backlog notes, and tech tags into Obsidian.

Community
Advanced
lgililgili

obsidian-pro

Design Obsidian vault structures and automate PKM workflows with Dataview and Templater.

Community
Advanced