sweep-drive

Detect orphaned Google Drive folders under ACE/ and generate triage reports.

1|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill sweep-drive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sweep-drive
Source: https://github.com/dimagi-internal/ace/tree/main/skills/sweep-drive
Command: npx skills add https://github.com/dimagi-internal/ace --skill sweep-drive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the clutter and risk of manual cleanup of orphaned Google Drive folders under the ACE/ directory that are no longer referenced by active Connect opportunities, eliminating the chance of accidentally deleting active project folders during ad-hoc cleanup.

Core Features & Use Cases

  • False Positive-Free Orphan Detection: Diffs the ACE/ folder list against the current live opp set, and probes folders to confirm they are actual opp-shaped folders (contain opp.yaml or an inputs/ subfolder) before flagging them as orphans, avoiding false positives from shared folders like templates or video libraries.
  • Confidence Scoring & Triage Reporting: Scores orphan candidates by confidence level, generates a human-readable markdown triage report and machine-readable YAML report for review, and only proposes high-confidence confirmed opp orphans for deletion.
  • Reversible Safe Trashing: When given human-approved folder IDs, trashes only the specified folders via Google Drive's API, with 30-day recovery via the Drive bin, and validates that trashed folders are removed post-operation.

Quick Start

Invoke the sweep-drive skill after completing a sweep-live-set run to generate a triage report of orphaned ACE Drive folders for human review, or execute approved trash operations if you have explicit human sign-off.

Frequently Asked Questions about sweep-drive

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

FAQPage Schema
How do I detect and clean up orphaned Google Drive folders not linked to active opportunities?

To detect orphaned Google Drive folders, this Skill diffs the ACE/ directory against active Connect opportunities and probes folders for opp.yaml or inputs/ subfolders to confirm they are true orphans before flagging them for triage.

How does orphaned folder detection avoid false positives on shared templates and video libraries?

Orphaned folder detection avoids false positives by probing each candidate folder to confirm it is an opportunity-shaped folder containing opp.yaml or an inputs/ subfolder, excluding shared non-opportunity folders like templates and video libraries.

How do I generate a triage report for ACE Drive folder cleanup?

You can generate a triage report by invoking this Skill after a sweep-live-set run, which produces scored markdown and YAML reports of confirmed orphaned opportunity folders for human review.

Is trashing orphaned Google Drive folders reversible if an active project is accidentally removed?

Trashing orphaned Google Drive folders is fully reversible via the Drive 30-day bin recovery, allowing safe restoration if an active project folder is accidentally approved for deletion.

Does Google Drive folder cleanup require manual review before deleting orphaned directories?

Google Drive folder cleanup requires explicit human sign-off, using confidence-scored triage reports to propose only high-confidence confirmed orphan folders for reversible trash operations.

What limitations exist when using automated Drive cleanup for ACE operations workflows?

Automated Drive cleanup is limited to the ACE/ directory scope and requires human-approved folder IDs to execute trashing, meaning it cannot auto-delete folders and only processes confirmed opp-shaped orphans to prevent accidental data loss.