boulevard

Compare Boulevard Admin API environments to detect missing categories and externalId mismatches.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/SuperCorks/agent-skills --skill boulevard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: boulevard
Source: https://github.com/SuperCorks/agent-skills/tree/main/boulevard
Command: npx skills add https://github.com/SuperCorks/agent-skills --skill boulevard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill identifies gaps and inconsistencies in Boulevard data by comparing Admin API results between environments (e.g., prod and sandbox). It surfaces missing categories and services and highlights externalId mismatches to guide safe, incremental synchronization.

Core Features & Use Cases

  • Cross-env comparison of service categories and services to surface differences.
  • Detects externalId gaps and lists mismatches to align identifiers across environments.
  • Provides actionable steps to create missing categories/services and backfill identifiers, ensuring parity for deployments and testing.

Quick Start

Run the boulevard skill against your environments to identify differences:

  • node scripts/diff-services.js --source-env=prod --source-business-id=YOUR_BUSINESS_ID --source-api-key=YOUR_API_KEY --source-api-secret=YOUR_API_SECRET --target-env=sandbox --target-business-id=YOUR_BUSINESS_ID --target-api-key=YOUR_API_KEY --target-api-secret=YOUR_API_SECRET Then review the JSON output and run the corresponding create/update scripts to synchronize.

Frequently Asked Questions about boulevard

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

FAQPage Schema
How do I compare Boulevard services and categories between prod and sandbox environments?

Compare Boulevard environments by querying the Admin API with paginated GraphQL to identify missing categories, missing services, and externalId mismatches, producing a JSON diff to guide selective creation and updates.

Why do my Boulevard externalId values mismatch across different environments?

externalId mismatches across Boulevard environments occur when categories or services are created independently without synced identifiers. Querying the Admin API surfaces these gaps so you can backfill identifiers and ensure parity for deployments.

What credentials do I need to run a Boulevard environment sync diff?

Running a Boulevard environment diff requires business-id, api-key, and api-secret credentials for both source and target environments, along with the respective environment endpoints to authenticate Admin API GraphQL queries.

Can I use GraphQL queries to detect missing service categories in my Boulevard sandbox?

Yes, the Admin API supports paginated GraphQL queries with rate-limit handling to detect missing service categories in your Boulevard sandbox by comparing results against your production environment data.

What is the best way to synchronize Boulevard data across environments without overwriting changes?

The best way to synchronize Boulevard data is performing an Admin API diff to surface missing categories and externalId mismatches, then applying selective creation and update scripts for incremental parity rather than bulk overwrites.

Does the Boulevard environment diff handle API rate limits during paginated GraphQL queries?

Yes, the Boulevard environment diff handles API rate limits during paginated GraphQL queries to ensure complete data retrieval when comparing service categories and externalId values across environments.