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

kiln-doctor

Validate Kiln project structures against the kiln manifest and fix deviations.

Updated Mar 26, 2026
Search Tags:#migration#cleanup#manifest#retention#project-health#doctor#kiln
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill kiln-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kiln-doctor
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-kiln/skills/kiln-doctor
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill kiln-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate Kiln project structures against the kiln manifest, detect legacy paths, and ensure version-sync and artifact retention rules are enforced.

Core Features & Use Cases

  • Diagnose project structure against kiln-manifest and identify missing directories, legacy paths, and version mismatches.
  • Migrate legacy paths automatically in diagnose or fix modes and cleanup stale artifacts per manifest.
  • Apply retention and version-sync checks, with safe, confirmed fixes and optional previews.

Quick Start

Run kiln-doctor in diagnose mode to generate a report of issues and recommended fixes.

Frequently Asked Questions about kiln-doctor

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

FAQPage Schema
How do I validate my Kiln project structure against the kiln manifest?▼

To validate a Kiln project structure against the kiln manifest, run a diagnosis to identify missing directories, detect legacy paths, and check for version mismatches. This generates a detailed report of structural deviations and recommended fixes.

What is the best way to migrate legacy paths in a Kiln plugin project?▼

Migrating legacy paths in a Kiln plugin project involves running diagnostic checks against the manifest and applying automated fixes. The tool enforces version-sync rules and applies structural corrections only after receiving explicit confirmation.

How does artifact retention cleanup work for stale Kiln project files?▼

Artifact retention cleanup enforces manifest rules by identifying and purging stale artifacts within the Kiln project. It supports optional purge operations and provides safe, confirmed fixes with previews to prevent accidental data loss.

Can I preview fixes before applying them to my Kiln manifest deviations?▼

Yes, you can preview fixes before applying them to your Kiln manifest deviations. The tool reports legacy paths and structural issues, applying rectifications only with explicit confirmation to ensure safe project state corrections.

When do I need to run a diagnosis on my Kiln project state?▼

You need to run a diagnosis on your Kiln project state during plugin project migrations, artifact retention cleanup scenarios, or when you suspect version mismatches and missing directories exist within your manifest structure.

Why does my Kiln project structure show legacy paths after a version sync?▼

Kiln project structures show legacy paths after a version sync due to deviations from the kiln manifest. Running a diagnostic check identifies these outdated paths and supports automatic migration to align the directory structure with current manifest requirements.

Related Skills

Explore More Software Engineering Skills→
PetitChuPetitChu

reconcile

Audit fiction project directories against Holocron plugin conventions and generate reconciliation reports.

Community
Intermediate
OrestesKOrestesK
2

ctx-purge

Purge context-mode knowledge base content and session data with confirmation.

Community
Basic
pikkujspikkujs
56

pikku-versioning

Hash Pikku function schemas into a versions.json manifest for CI checks.

Official
Advanced
intraleintrale

cleanup

Remove logs, stale sessions, worktrees, build caches, and temporary files.

Official
Advanced