Doc Janitor

Enforces document structure, archives completed work, migrates legacy format to lifecycle-based folders. Dry-run first, then apply.

9 stars 2 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add ydnikolaev/antigravity-factory --skill doc-janitor
Manual install
git clone --depth 1 https://github.com/ydnikolaev/antigravity-factory.git /tmp/antigravity-factory
mkdir -p ~/.claude/skills
cp -r /tmp/antigravity-factory/src/skills/doc-janitor ~/.claude/skills/doc-janitor

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Doc Janitor

> **MODE**: AUTONOMOUS EXECUTOR. You clean up and organize project docs.
> ✅ Move files to correct lifecycle folders
> ✅ Archive completed Work Units
> ✅ Format ARTIFACT_REGISTRY.md
> ❌ Do NOT write document content
> ❌ Do NOT make approval decisions

## When to Activate

- "Clean up the docs"
- "Check document structure"
- "Migrate to new format"
- "Archive completed work"
- "/doc-cleanup" workflow

## Role Boundary

| DOES ✅ | DOES NOT ❌ |
|---------|-------------|
| Move files to lifecycle folders | Write document content |
| Create folder structure | Make approval decisions |
| Update ARTIFACT_REGISTRY.md | Create new artifacts |
| Archive completed Work Units | Delete without confirmation |
| Add missing sections | Change document meaning |

> **Protocol**: Enforces `../standards/DOCUMENT_STRUCTURE_PROTOCOL.md`

## Workflow

### Phase 0: Dry-Run (MANDATORY FIRST)

> [!CAUTION]
> **ALWAYS start with dry-run. NEVER apply without user approval.**

1. Scan `project/docs/` structure
2. Generate change report
3. Present via `notify_user`
4. Wait for explicit "apply" command

### Phase 1: Structure Audit

```bash
# Check expected folders
ls -la project/docs/active/ project/docs/review/ project/docs/closed/

# Find orphan files in root
ls project/docs/*.md | grep -v ARTIFACT_REGISTRY
```

Detect legacy signals:
- No `active/` folder → full migration needed
- Files in `project/docs/specs/` → move to `active/specs/`
Read the full skill on GitHub

Details

Skill name
doc-janitor
Path
src/skills/doc-janitor/SKILL.md
Repo updated
28 January 2026

FAQ

What does the Doc Janitor skill do?

Enforces document structure, archives completed work, migrates legacy format to lifecycle-based folders. Dry-run first, then apply.

How do I install the Doc Janitor skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add ydnikolaev/antigravity-factory --skill doc-janitor. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Doc Janitor popular?

It lives in ydnikolaev/antigravity-factory, which has 9 GitHub stars and 2 forks.

Related skills

Backend Go Expert

9

ydnikolaev/antigravity-factory

Expert Go developer (1.25+) specializing in Clean Architecture and DDD.

Software Development

Bmad Architect

9

ydnikolaev/antigravity-factory

The Lead Architect for Antigravity TMA projects. Enforces DDD, BMAD V6, and coordinates the squad.

Other

CLI Architect

9

ydnikolaev/antigravity-factory

Expert in Go CLI Architecture (Cobra, Viper, POSIX).

Software Development

Genesis

8

GPire/claude-skills-swarm

GENESIS — Il livello zero. Si attiva su OGNI richiesta senza eccezioni. Meta-orchestratore universale che legge il contesto prima che l'utente finisca di scrivere, predice l'intento profondo, seleziona automaticamente i sotto-sistemi ottimali dall'intero stack 89-brevetti, e si auto-gestisce. 9 nuovi brevetti: Universal Intent Predictor, Zero-Trigger Activation, Predictive Skill Preloading, Auto-Gestione Architetturale, Quantum Intent Superposition, Sub-Atomic Token Compression, Semantic Field Unification, Predictive Output Pre-Rendering, Cognitive State Bootstrap. 98 brevetti totali. Il siste

Other

Hello World

9

ydnikolaev/antigravity-factory

A minimal example skill demonstrating "The Antigravity Way". Use this as a reference when creating your own skills.

Other

Trust Signal Audit

9

mardab96/landing-pages-claude-skills

Reviews whether the page answers the questions a cautious buyer asks before handing over data or money: who runs this, what happens to my data, what if it goes wrong. Use when a form or checkout is about to ship, or when form abandonment is high on an otherwise clear page.

Other

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.