kiln-cleanup

Purge stale QA artifacts from .kiln/qa/ subdirectories with optional dry-run preview.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kiln Cleanup removes accumulated QA artifacts from the .kiln/qa/ directory to reclaim disk space and keep environments tidy. It also supports a dry-run mode to preview exactly what would be removed without deleting anything.

Core Features & Use Cases

  • Purges stale QA artifacts from .kiln/qa/ (test-results, playwright-report, videos, traces, screenshots, results) to reclaim disk space.
  • Supports --dry-run to preview deletions and confirm impact before enforcing changes.
  • Preserves the directory structure and operates idempotently, ensuring repeated runs don't delete already-purged content.

Quick Start

Run the Kiln Cleanup process with --dry-run to preview removals, then run without --dry-run to perform the purge.

Frequently Asked Questions about kiln-cleanup

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

FAQPage Schema
How do I clean up stale QA artifacts to reclaim disk space?

To clean up stale QA artifacts, purge subdirectories like test-results, playwright-report, videos, traces, and screenshots. The process operates idempotently to safely remove accumulated files while preserving the directory structure.

Can I preview what files will be deleted before purging QA artifacts?

Yes, you can preview deletions by running the purge in dry-run mode. Dry-run reports the counts and sizes of stale artifacts across all subdirectories without actually deleting anything, allowing you to confirm the impact first.

What happens if the .kiln/qa/ directory is missing during an artifact purge?

If the .kiln/qa/ directory is missing during an artifact purge, the process gracefully handles it without throwing errors. It simply skips the deletion and provides a final summary of the actions taken or planned.

Does artifact cleanup work idempotently across multiple runs?

Yes, artifact cleanup works idempotently across multiple runs. Repeated executions do not delete already-purged content or cause errors, ensuring safe automation for reclaiming disk space from Playwright reports and test results.

What is the best way to automate purging Playwright videos and traces?

The best way to automate purging Playwright videos and traces is to run the cleanup without dry-run mode after verifying the impact. This safely removes stale files from the .kiln/qa/ directory and reports the reclaimed disk space.