What is search-content?

This Claude skill enables advanced search and discovery across Confluence wikis using CQL-based queries. It allows users to efficiently locate documentation, meeting notes, and blog posts by filtering through spaces, labels, contributors, and modification dates, while providing hierarchical context for better information retrieval and knowledge management.

When should I use search-content?

search-content is useful in the following scenarios: • Technical Documentation Discovery: Quickly find API references, deployment guides, or architecture decisions within specific Confluence spaces using text search or labels. • Meeting Note Retrieval: Locate recent meeting notes or project updates by filtering for content types like 'blogpost' or specific date ranges. • Content Audit and Management: Identify deprecated content or pages modified within a certain timeframe to maintain the accuracy and relevance of the internal knowledge base. • Contributor Tracking: Search for all documentation authored by a specific team member to streamline handovers, performance reviews, or knowledge sharing. • Hierarchical Context Mapping: Understand the structure of documentation by viewing parent page information alongside search results to navigate complex wiki architectures.

name	search-content
description	This skill MUST be used when the user asks to "search Confluence", "find pages", "search wiki", "look for documentation", "find content about", or wants to search for pages across Confluence. Use this for content discovery and search.

Search Confluence Content

IMPORTANT: Always use this skill's Python script for searching Confluence. This skill provides CQL-based search with token-efficient output, including parent hierarchy information.

Quick Start

Use the Python script at scripts/search_confluence.py:

# Simple text search
python scripts/search_confluence.py "authentication"

# Search in specific space
python scripts/search_confluence.py "API documentation" --space DEV

# Search with type filter
python scripts/search_confluence.py "meeting notes" --type blogpost

# Search by label
python scripts/search_confluence.py --label "architecture"

Options

Option	Description
`query`	Search text (positional argument)
`--space`, `-s`	Limit search to specific space
`--type`, `-t`	Content type: page, blogpost, comment
`--label`, `-l`	Search for content with specific label
`--contributor`	Search by content contributor
`--modified-after`	Content modified after date (YYYY-MM-DD)
`--modified-before`	Content modified before date (YYYY-MM-DD)
`--limit`	Maximum results (default: 25)
`--format`, `-f`	Output: compact (default), text, json

Search Types

Text Search

Search in page titles and content:

python scripts/search_confluence.py "deployment guide"

Label Search

Find pages with specific labels:

python scripts/search_confluence.py --label "api-reference"

Combined Search

python scripts/search_confluence.py "authentication" --space DEV --label "security"

CQL (Confluence Query Language)

This skill uses CQL internally. Advanced users can leverage CQL patterns:

Search Pattern	CQL Equivalent
Text search	`text ~ "query"`
Space filter	`space = "KEY"`
Type filter	`type = page`
Label filter	`label = "name"`
Date filter	`lastModified >= "2024-01-01"`

Common Workflows

Find Documentation

# Find all API-related docs
python scripts/search_confluence.py "API" --space DEV --type page

# Find recent changes
python scripts/search_confluence.py "" --space DEV --modified-after 2024-01-01

Find Meeting Notes

python scripts/search_confluence.py "meeting notes" --type blogpost --limit 10

Find by Label

# Find all architecture decisions
python scripts/search_confluence.py --label "adr"

# Find deprecated content
python scripts/search_confluence.py --label "deprecated" --space DEV

Find Contributor's Content

python scripts/search_confluence.py --contributor "john.smith" --space DEV

Output Formats

compact (default):

SEARCH|5|"authentication"
HIT|123456|Authentication Guide|DEV|page|parent:Security Docs
HIT|123457|OAuth Setup|DEV|page|parent:Authentication Guide
HIT|123458|SSO Integration|DEV|page|parent:Authentication Guide
HIT|123459|Security Best Practices|DEV|page
HIT|123460|Login Flow|DEV|page|parent:User Management

Note: Parent information is included when available (e.g., parent:Security Docs).

text:

Search Results: "authentication" (5 found)

1. Authentication Guide
   ID: 123456 | Space: DEV | Type: page | Parent: Security Docs
   URL: https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123456

2. OAuth Setup
   ID: 123457 | Space: DEV | Type: page | Parent: Authentication Guide
   URL: https://yoursite.atlassian.net/wiki/spaces/DEV/pages/123457
...

json:

{
  "query": "authentication",
  "count": 5,
  "results": [
    {
      "id": "123456",
      "title": "Authentication Guide",
      "space": "DEV",
      "type": "page",
      "url": "...",
      "parentId": "123400",
      "parentTitle": "Security Docs"
    }
  ]
}

Parent Information

Search results now include parent/hierarchy information when available:

parentId - ID of the direct parent page or folder
parentTitle - Title of the direct parent

This helps understand where each result is located in the content hierarchy.

Environment Setup

Requires environment variables:

CONFLUENCE_BASE_URL - e.g., https://yoursite.atlassian.net
CONFLUENCE_EMAIL - Your Atlassian account email
CONFLUENCE_API_TOKEN - API token from Atlassian account settings

Reference

For detailed options, see references/options-reference.md.

search-content

When & Why to Use This Skill

Use Cases