| 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 trafficbottom <N> - Lowest traffic pagestrending - Pages with increasing trafficdeclining - Pages losing trafficsummary <domain> - Analytics overviewcheck <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 resultsget <filename> - Get specific research resultreddit -s <subreddit> - Monitor Reddit discussionshackernews - Monitor Hacker Newsfeeds <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 prioritizationaudit-traffic --domain <domain> - Traffic audit reportimpact-estimate --topic <topic> - Estimate content opportunity valuecompare-gaps --own <domain> --competitor <domain> - Find missing contentcompare-coverage --own <domain> --competitor <domain> - Compare content types/topicscompare-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
OPERATION=$1
case "$OPERATION" in
top|bottom|trending|declining|summary|check)
invoke: subskills/analytics.md
;;
search|list|get|reddit|hackernews|feeds)
invoke: subskills/research.md
;;
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 contentkurt content stats - Content statisticskurt research - External research commandskurt cluster-urls - Topic clustering
Works with:
content-writing-skill - Intelligence identifies targets, writing creates contentcms-interaction-skill - Intelligence analyzes, CMS managesworkflow-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
See Also
- project-management-skill - Uses intelligence in Step 4 (identify targets)
- content-intelligence subskill - Detailed implementation of complex operations
- analytics subskill - Traffic analysis implementation
- research subskill - External research implementation
