doc-janitor

Validate YAML frontmatter and migrate documents across lifecycle folders.

8|3|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/ydnikolaev/antigravity-factory --skill doc-janitor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-janitor
Source: https://github.com/ydnikolaev/antigravity-factory/tree/main/src/skills/doc-janitor
Command: npx skills add https://github.com/ydnikolaev/antigravity-factory --skill doc-janitor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill cleans up and organizes project docs by enforcing a consistent lifecycle-based folder structure, migrating legacy formats, and archiving completed work, starting with a safe dry-run.

Core Features & Use Cases

  • Enforce YAML frontmatter structure and existence of essential sections in project docs
  • Migrate documents into active/review/closed lifecycle folders and update ARTIFACT_REGISTRY.md
  • Archive completed Work Units and generate structured cleanup reports

Quick Start

Run the doc-janitor skill on your repository to perform a dry-run cleanup of the docs, then apply the changes.

Frequently Asked Questions about doc-janitor

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

FAQPage Schema
How do I enforce document structure and organize project docs by lifecycle status?

Document structure is enforced by validating YAML frontmatter and migrating files into active, review, and closed lifecycle folders, ensuring consistent organization and tracking of each file's lifecycle status.

What is the best way to archive completed work units in a documentation repository?

Archiving completed work units is handled by moving them into closed lifecycle folders and updating the project's ARTIFACT_REGISTRY.md file, generating a structured cleanup report detailing the archived artifacts.

Can I preview documentation cleanup changes before modifying my project repository?

Yes, you can preview changes by running the skill in dry-run mode, which safely analyzes the documentation repository, reports frontmatter validation errors, and shows lifecycle migration actions without applying modifications.

Does this documentation cleanup tool require existing YAML frontmatter in my project files?

Yes, the skill reads YAML frontmatter to validate document structure and lifecycle rules, enforcing the existence of essential sections to properly migrate documents across active, review, and closed folders.

How do I migrate legacy documentation formats into a lifecycle folder structure?

Legacy formats are migrated by validating YAML frontmatter and moving documents into active, review, or closed lifecycle directories, updating the ARTIFACT_REGISTRY.md file while optionally archiving completed work units.