AGENT SKILL

revenue-intelligence

暂无简介

License 许可
MIT
最近更新
2026-11-10
Stars
★ 1
Forks
0

02 资源文件 4

03 SKILL.md 正文

AI Revenue Intelligence

Preamble (runs on skill start)

# Version check (silent if up to date)
python3 telemetry/version_check.py 2>/dev/null || true

# Telemetry opt-in (first run only, then remembers your choice)
python3 telemetry/telemetry_init.py 2>/dev/null || true

Privacy: This skill logs usage locally to ~/.ai-marketing-skills/analytics/. Remote telemetry is opt-in only. No code, file paths, or repo content is ever collected. See telemetry/README.md.


AI-powered revenue intelligence: sales call insight extraction, content-to-revenue attribution, and multi-source client reporting.

When to Use

  • User wants to extract insights from Gong sales call transcripts
  • User needs to identify objections, buying signals, or competitive mentions in calls
  • User wants to prove content ROI by mapping content to closed deals
  • User needs revenue attribution across first-touch and multi-touch models
  • User wants to generate a unified client report from GA4 + HubSpot + Ahrefs + Gong
  • User asks about content gaps in the buyer journey
  • User needs anomaly detection across marketing metrics

Tools

Gong-to-Insight Pipeline (gong_insight_pipeline.py)

Extracts structured intelligence from sales call transcripts. Works with Gong API or plain transcript files.

# Analyze a single transcript file
python gong_insight_pipeline.py --file transcript.txt

# Analyze multiple transcript files
python gong_insight_pipeline.py --dir ./transcripts/

# Pull recent calls from Gong API (last 7 days)
python gong_insight_pipeline.py --gong --days 7

# Pull specific call by ID
python gong_insight_pipeline.py --gong --call-id abc123

# Output as JSON file
python gong_insight_pipeline.py --file transcript.txt --output insights.json

# Generate content topics from recurring objections
python gong_insight_pipeline.py --dir ./transcripts/ --content-topics

# Generate follow-up suggestions for outbound sequences
python gong_insight_pipeline.py --file transcript.txt --follow-ups

What it extracts:

  • Objections (categorized: pricing, timing, competition, authority, need)
  • Buying signals (budget confirmed, timeline mentioned, decision maker engaged, champion identified)
  • Competitive mentions (who was mentioned, context: positive/negative/neutral)
  • Pricing discussions (anchors, pushback, willingness indicators)
  • Content topic suggestions from recurring objection patterns
  • Personalized follow-up drafts based on call context

Output: Structured JSON to stdout or file. Each call produces an insights object with objections, buying_signals, competitive_mentions, pricing_discussions, content_topics, and follow_ups arrays.

Revenue Attribution Mapper (revenue_attribution.py)

Maps content pieces to pipeline and closed revenue. Proves content ROI with first-touch and multi-touch attribution.

# Run full attribution report (GA4 + HubSpot)
python revenue_attribution.py --report

# First-touch attribution only
python revenue_attribution.py --report --model first-touch

# Multi-touch (linear) attribution
python revenue_attribution.py --report --model linear

# Time-decay attribution
python revenue_attribution.py --report --model time-decay

# Filter by date range
python revenue_attribution.py --report --start 2025-01-01 --end 2025-03-31

# Calculate cost-per-acquisition by content type
python revenue_attribution.py --cpa --costs content_costs.json

# Identify content gaps in the buyer journey
python revenue_attribution.py --gaps

# Output as JSON
python revenue_attribution.py --report --json --output attribution.json

What it produces:

  • Content-to-revenue mapping (which blog posts, videos, podcasts drove deals)
  • First-touch, linear, and time-decay attribution models
  • Cost-per-acquisition by content type (blog, video, podcast, webinar)
  • Content ROI report with revenue per piece
  • Content gap analysis (funnel stages with no attribution)
  • Top-performing content ranked by attributed revenue

Data sources: GA4 (page paths, sessions, conversions) + HubSpot (deals, touchpoints, close dates)

Multi-Source Client Report Generator (client_report_generator.py)

Generates unified client-ready BI reports from GA4, HubSpot, Ahrefs, and Gong.

# Generate full client report
python client_report_generator.py --client "Acme Corp"

# Specify date range
python client_report_generator.py --client "Acme Corp" --start 2025-03-01 --end 2025-03-31

# Output as markdown
python client_report_generator.py --client "Acme Corp" --format markdown --output report.md

# Output as JSON (for rendering in slides/dashboards)
python client_report_generator.py --client "Acme Corp" --format json --output report.json

# Skip specific data sources
python client_report_generator.py --client "Acme Corp" --skip gong
python client_report_generator.py --client "Acme Corp" --skip ahrefs,gong

# Enable anomaly detection
python client_report_generator.py --client "Acme Corp" --anomalies

# Compare to previous period
python client_report_generator.py --client "Acme Corp" --compare previous-month

What it produces:

  • Executive summary with key metrics and period-over-period changes
  • Traffic section: sessions, users, top pages, channel breakdown (GA4)
  • Pipeline section: deals created, moved, closed, revenue (HubSpot)
  • SEO section: keyword rankings, backlinks, domain rating changes (Ahrefs)
  • Call quality section: talk ratios, objection frequency, win rates (Gong)
  • Anomaly flags: unusual spikes/drops with severity and context
  • Output as structured markdown or JSON

Configuration

All scripts read from environment variables. Copy .env.example to .env and fill in your values.

Required Environment Variables

Variable Used By Description
GONG_API_KEY Gong Pipeline, Client Report Gong API access key
GONG_API_BASE_URL Gong Pipeline, Client Report Gong API base URL
HUBSPOT_API_KEY Attribution, Client Report HubSpot private app token
GA4_PROPERTY_ID Attribution, Client Report GA4 property ID
GA4_CREDENTIALS_JSON Attribution, Client Report Path to GA4 service account JSON

Optional Environment Variables

Variable Used By Description
AHREFS_TOKEN Client Report Ahrefs API token
OUTPUT_DIR All Directory for output files (default: ./output)

Data Flow

Gong Transcripts → Insight Pipeline → Objections, Signals, Competitors → Content Topics + Follow-ups
GA4 + HubSpot   → Attribution Mapper → Content ROI, CPA, Gap Analysis → Revenue Proof
GA4 + HubSpot + Ahrefs + Gong → Client Report → Executive Summary + Anomalies → Client Deliverable

Recommended Workflow

  1. Weekly: Run gong_insight_pipeline.py --gong --days 7 to extract call intelligence
  2. Monthly: Run revenue_attribution.py --report to prove content ROI
  3. Monthly: Run client_report_generator.py for each client deliverable
  4. Quarterly: Run revenue_attribution.py --gaps to find content gaps
  5. Ongoing: Feed Gong insight follow-ups into outbound sequences

Dependencies

pip install -r requirements.txt

04 同仓库更多 Skills

YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

vercel-sandbox

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

slack

Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include "check my Slack", "what channels have unreads", "send a message to", "search Slack for", "extract from Slack", "find who said", or any task requiring programmatic Slack interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

electron

Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

shadcn

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", "switch to --preset", and for building a design system or applying a DESIGN.md or brand spec to shadcn/ui.

★ 1