name	intelligence
description	Information gathering utilities (analytics, research, content analysis) (general)

Intelligence Skill

Overview

This skill provides comprehensive information gathering utilities for project planning and content analysis. It consolidates analytics queries, external research, and content intelligence operations into a single skill.

Key principle: This is a utility skill - it wraps Kurt CLI commands and provides low-level operations. It can be used directly by users OR called by higher-level skills (like project-management, workflows).

Primary use case: During project planning (Step 4 of create-project) to identify what content needs work.

When to Use This Skill

✅ Use intelligence-skill when:

Analyzing traffic patterns to find content issues (audit-traffic)
Finding content about specific topics with traffic data (identify-affected)
Researching topics with AI (search)
Monitoring community discussions (reddit, hackernews, feeds)
Comparing content coverage vs competitors (compare-gaps, compare-coverage)
Quick analytics spot-checks (top, bottom, trending)

❌ Don't use intelligence-skill when:

Creating or editing content → Use content-writing-skill
Managing CMS content → Use cms-interaction-skill
Managing projects → Use project-management-skill

Rule of thumb: If it's gathering information or analyzing data, use this skill. If it's creating/managing content, use other skills.

Operations (18 total, 3 categories)

Analytics Operations (6)

Low-level traffic queries for spot-checking and analysis.

top <N> - Top pages by traffic
bottom <N> - Lowest traffic pages
trending - Pages with increasing traffic
declining - Pages losing traffic
summary <domain> - Analytics overview
check <url> - Traffic for specific page

External Research Operations (6)

Research from external sources (AI, Reddit, Hacker News, RSS).

search "<query>" - AI-powered research (Perplexity)
list - Browse past research results
get <filename> - Get specific research result
reddit -s <subreddit> - Monitor Reddit discussions
hackernews - Monitor Hacker News
feeds <url> - Monitor RSS/Atom feeds

Content Intelligence Operations (6)

Complex analysis combining content + analytics for project planning.

identify-affected --search-term <term> - Find content with traffic prioritization
audit-traffic --domain <domain> - Traffic audit report
impact-estimate --topic <topic> - Estimate content opportunity value
compare-gaps --own <domain> --competitor <domain> - Find missing content
compare-coverage --own <domain> --competitor <domain> - Compare content types/topics
compare-quality --own <domain> --competitor <domain> - Compare depth/quality metrics

Operation Details

Analytics Operations

top - Top pages by traffic

Use: Quick check for most popular content
Example: intelligence top 10

bottom - Lowest traffic pages

Use: Find zero-traffic/orphaned pages
Example: intelligence bottom 10

trending - Pages with increasing traffic

Use: Find momentum topics to expand on
Example: intelligence trending

declining - Pages losing traffic

Use: Urgent attention needed (high traffic + declining = critical)
Example: intelligence declining

summary - Analytics overview

Use: Understand traffic distribution and health
Example: intelligence summary docs.company.com

check - Traffic for specific URL(s)

Use: Spot-check traffic during planning
Example: intelligence check "bigquery"

Research Operations

search "" - AI-powered research (Perplexity)

Use: Gather reference sources for projects
Flags: --recency hour|day|week|month, --save
Example: intelligence search "AI tools trends" --recency week --save

list - Browse past research get - Retrieve specific research

reddit -s - Monitor Reddit discussions

Use: Find what audience is discussing
Example: intelligence reddit -s dataengineering --min-score 10

hackernews - Monitor HN discussions feeds - Monitor RSS/Atom feeds

Content Intelligence Operations

identify-affected --search-term - Find content with traffic prioritization

Use: Update content about specific topic
Priority matrix: CRITICAL (high traffic + declining) → ZERO (no traffic)
Example: intelligence identify-affected --search-term "bigquery" --content-type tutorial

audit-traffic --domain - Comprehensive traffic audit

Use: Domain-wide health check
Finds: High-traffic stale, declining traffic, zero-traffic pages
Example: intelligence audit-traffic --domain docs.company.com

impact-estimate --topic - Estimate new content opportunity

Use: Prioritize new content creation
Returns: HIGH/MEDIUM/LOW impact estimate
Example: intelligence impact-estimate --topic "security" --domain docs.company.com

compare-gaps --own --competitor - Find missing content

Use: Identify content you don't have vs competitor
Prerequisite: Competitor content must be indexed
Example: intelligence compare-gaps --own docs.yourco.com --competitor docs.competitor.com

compare-coverage --own --competitor - Compare content types

Use: Understand content mix gaps (tutorials, guides, examples)
Example: intelligence compare-coverage --own docs.yourco.com --competitor docs.competitor.com

compare-quality --own --competitor - Compare content depth

Use: Set quality bar for content
Compares: word count, code examples, images, update frequency
Example: intelligence compare-quality --own docs.yourco.com --competitor docs.competitor.com

Common Workflows

For updating docs: audit-traffic → select high-priority items For new content: compare-gaps + impact-estimate → prioritize topics For competitive analysis: compare-gaps + compare-coverage + compare-quality For research: search + reddit/hackernews → gather sources

Routing Logic

# Parse first argument to determine operation type
OPERATION=$1

case "$OPERATION" in
  # Analytics operations → analytics subskill
  top|bottom|trending|declining|summary|check)
    invoke: subskills/analytics.md
    ;;

  # Research operations → research subskill
  search|list|get|reddit|hackernews|feeds)
    invoke: subskills/research.md
    ;;

  # Content intelligence operations → content-intelligence subskill
  identify-affected|audit-traffic|impact-estimate|compare-gaps|compare-coverage|compare-quality)
    invoke: subskills/content-intelligence.md
    ;;

  *)
    echo "Unknown operation: $OPERATION"
    echo ""
    echo "Available operations:"
    echo "  Analytics: top, bottom, trending, declining, summary, check"
    echo "  Research: search, list, get, reddit, hackernews, feeds"
    echo "  Content Intelligence: identify-affected, audit-traffic, impact-estimate,"
    echo "                        compare-gaps, compare-coverage, compare-quality"
    echo ""
    echo "See 'Operation Details' section in intelligence-skill/SKILL.md for usage examples"
    exit 1
    ;;
esac

Integration with Other Skills

Called by:

project-management-skill (Step 4 - identify targets during project planning)
workflow-skill (default workflows use intelligence operations)
Direct user invocation for ad-hoc analysis

Uses:

kurt content list - Query indexed content
kurt content stats - Content statistics
kurt research - External research commands
kurt cluster-urls - Topic clustering

Works with:

content-writing-skill - Intelligence identifies targets, writing creates content
cms-interaction-skill - Intelligence analyzes, CMS manages
workflow-skill - Workflows compose intelligence operations

Key Principles

Utility skill - Low-level, composable operations
Modular subskills - Load only needed operations (context efficiency)
Used during planning - Primarily for project planning (Step 4)
Data-driven - Combines content metadata + analytics + external research
Delegates to CLI - Wraps kurt commands, doesn't reimplement logic

intelligence

Install Skill

SKILL.md