agentleFS
TomGranotTomGranot/hubspot-admin-skills/skills/cleanup-dashboards/SKILL.md

cleanup-dashboards

Skill75 starsChanged 20 days agoMITView on GitHub

Audit and consolidate HubSpot reporting dashboards. Identifies unused, duplicate, or outdated dashboards. Must be performed manually — no dashboard API is available.

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Create a spreadsheet listing every dashboard:

    line 29
  2. Distinctive:

    Delete confirmed unused dashboards.

    line 48
  3. Distinctive:

    Before deleting, screenshot each dashboard or note which reports it contained.

    line 56
  4. Distinctive:

    If a report on a dashboard shows stale or broken data, fix the underlying report rather than creating a new dashboard.

    line 63

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Cleanup Dashboards

Audit HubSpot dashboards to remove clutter and consolidate reporting. Too many dashboards means nobody uses any of them effectively.

Important Limitation

HubSpot does not provide a Dashboard API. This entire process must be performed manually in the HubSpot UI under Reports > Dashboards.

Prerequisites

  • HubSpot portal access with dashboard management permissions
  • Input from team members on which dashboards they actively use

Step-by-Step Instructions

Stage 1: Before — Inventory All Dashboards

  1. Navigate to Reports > Dashboards in HubSpot.
  2. Create a spreadsheet listing every dashboard:
    • Name, owner/creator, number of reports, last viewed date (if visible), purpose

Stage 2: Execute — Identify Candidates for Removal

Flag dashboards matching any of these criteria:

  1. Not viewed in 90+ days (check with the owner first)
  2. Duplicate dashboards covering the same metrics
  3. Test dashboards (names containing "test", "draft", "copy of")
  4. Personal dashboards belonging to departed employees
  5. Default dashboards that were never customized

Consolidation targets:

  • Merge dashboards with overlapping report widgets into a single comprehensive dashboard.
  • Aim for 5-10 core dashboards maximum (e.g., Marketing Overview, Sales Pipeline, Email Health, Data Quality, Executive Summary).

Stage 3: After — Clean Up and Reorganize

  1. Delete confirmed unused dashboards.
  2. Rename remaining dashboards with a clear naming convention (e.g., [Team] - Purpose).
  3. Set appropriate sharing/visibility for each dashboard.
  4. Communicate changes to the team — share links to the consolidated dashboards.

Stage 4: Rollback

  • Deleted dashboards cannot be restored.
  • Before deleting, screenshot each dashboard or note which reports it contained.
  • Individual reports within a dashboard are not deleted when the dashboard is removed — they remain available for re-use.

Tips

  • Assign a dashboard owner for each core dashboard — someone responsible for keeping it current.
  • Review dashboards quarterly as part of the database cleanup routine.
  • If a report on a dashboard shows stale or broken data, fix the underlying report rather than creating a new dashboard.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.