cleanup-workflows

Audit HubSpot workflows and delete dead, test, or deprecated automations.

58|16|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill cleanup-workflows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanup-workflows
Source: https://github.com/TomGranot/hubspot-admin-skills/tree/main/skills/cleanup-workflows
Command: npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill cleanup-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing HubSpot workflows often leads to hidden dead weight: unused, test, or deprecated automations clutter the automation dashboard and make it harder to understand what is actually running.

Core Features & Use Cases

  • Inventory all workflows: Pulls every workflow and records key properties (ID, name, enabled status, enrollments, and timestamps) to surface candidates for cleanup.
  • Identify candidates for deletion: Flags workflows that are off for 90+ days, have zero enrollments, are labeled as test/draft, or have been superseded.
  • Safe deletion & documentation: Deactivates when needed, deletes after verification, and logs actions with owner notifications to preserve accountability.
  • Rollback safeguards: Provides rollback steps and preserves activity history for audit and potential recreation.

Quick Start

Run the audit to enumerate all workflows and identify candidate deletions with accompanying documentation.

Frequently Asked Questions about cleanup-workflows

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

FAQPage Schema
How do I audit HubSpot workflows for inactive or deprecated automations?

Auditing HubSpot workflows involves pulling every workflow to record key properties like ID, enabled status, and enrollments, flagging inactive, test, or superseded candidates for cleanup. This process identifies automations off for 90+ days or with zero enrollments.

What is the best way to clean up unused HubSpot workflows safely?

The best way to clean up unused HubSpot workflows safely is to deactivate them, verify, and then delete them while logging all actions and notifying owners. This preserves accountability and provides rollback safeguards by keeping activity history for potential recreation.

Can I identify test or draft HubSpot workflows automatically for deletion?

Yes, you can identify test or draft HubSpot workflows automatically by flagging workflows labeled as such during the audit. The audit also catches workflows with zero enrollments or those superseded by newer versions as candidates for deletion.

Do I need API access to prune dead HubSpot workflows?

Yes, you need API access to prune dead HubSpot workflows, along with accurate workflow data and safe deletion procedures. This access enables you to pull workflow properties, deactivate automations, and log actions with owner notifications.

What are the limitations when managing large HubSpot portals with many workflows?

When managing large HubSpot portals with many workflows, limitations include the risk of accidentally deleting active automations and the need for accurate workflow data. Safe deletion procedures with logging and rollback safeguards are required to preserve accountability.