Skip to content

Add crm-query and crm-reports skills (CLI-friendly CRM data querying)#1

Draft
m-roll wants to merge 1 commit into
mainfrom
crm-query-public
Draft

Add crm-query and crm-reports skills (CLI-friendly CRM data querying)#1
m-roll wants to merge 1 commit into
mainfrom
crm-query-public

Conversation

@m-roll

@m-roll m-roll commented Jun 3, 2026

Copy link
Copy Markdown

Summary

  • Adds crm-query skill — CLI equivalent of the Breeze crm-query skill, using hubspot objects search, properties list, pipelines, associations, and owners commands for schema discovery, record filtering, counting, and owner lookup
  • Adds crm-reports skill — wraps hubspot reports create "<sql>" for server-side aggregations, GROUP BY, time series, and cross-object filters in a single call
  • Adds reference files: crm-query/resources/filter-operators.md (full filter syntax), crm-query/resources/aggregation-patterns.md (jq fallback cookbook), crm-reports/resources/sql-syntax.md (canonical SQL grammar)

The two skills are designed to work together: crm-query for simple filter/list/count, crm-reports for anything requiring server-side computation. Gaps with no CLI path (web analytics, marketing email metrics, LLM content analysis) are surfaced explicitly in crm-query rather than producing misleading workarounds.

Test plan

  • crm-query and crm-reports frontmatter (name, description, triggers) are coherent and non-overlapping
  • All cross-skill references (crm-lookup, crm-reports, sales-reporting, bulk-operations) point to existing skills
  • crm-query correctly delegates aggregation/cross-object cases to crm-reports
  • crm-reports SQL examples match the syntax documented in resources/sql-syntax.md
  • jq snippets in aggregation-patterns.md are syntactically valid

🤖 Generated with Claude Code

crm-query: translates the Breeze crm-query skill into hubspot CLI equivalents
— objects search, properties list, pipelines, associations, and owners commands.
Covers schema discovery, record filtering, counting, and owner lookup.

crm-reports: wraps hubspot reports create "<sql>" for server-side aggregations,
GROUP BY, time series, and cross-object filters in a single call.

The two skills are designed to work together: crm-query for simple filter/list/count,
crm-reports for anything requiring server-side computation. Gaps with no CLI path
(web analytics, marketing email metrics, LLM content analysis) are surfaced
explicitly in crm-query.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant