confluence-lookup

Search Confluence pages using CQL queries and link results to task YAML.

1|Updated Mar 1, 2026

Search Tags:#documentation #search #knowledge base #cql #confluence #task context

Ready to run

npx skills add https://github.com/hjemmesidekongen/ai --skill confluence-lookup

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: confluence-lookup
Source: https://github.com/hjemmesidekongen/ai/tree/main/plugins/herold/skills/confluence-lookup
Command: npx skills add https://github.com/hjemmesidekongen/ai --skill confluence-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you quickly find relevant documentation in Confluence that relates to your current development task, preventing you from reinventing the wheel or missing crucial information.

Core Features & Use Cases

Automated Keyword Extraction: Identifies key terms from your task's summary, description, and labels.
Intelligent CQL Querying: Constructs precise Confluence Query Language (CQL) strings to find the most relevant pages.
Relevance Scoring: Ranks search results based on keyword matches, recency, and project context.
Task Context Linking: Appends links to relevant Confluence pages directly into your task YAML for easy access.
Use Case: When working on a task like "Implement user authentication flow," this Skill can automatically search Confluence for pages on "authentication," "SSO," or "user management" and link them to your task.

Quick Start

Use the confluence-lookup skill to find documentation related to the active task.

Frequently Asked Questions about confluence-lookup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automatically find Confluence documentation relevant to my active development task?▼

This tool finds Confluence documentation by extracting keywords from your task summary, description, and labels to construct and execute CQL queries. It scores results by relevance and links matching pages to your task context in YAML format.

What is CQL and how does it help search a knowledge base for task context?▼

CQL, or Confluence Query Language, is used to construct precise search strings for finding relevant pages in a knowledge base. The tool builds these queries automatically from your task's extracted keywords to retrieve and score matching documentation.

Do I need a Confluence MCP configured to search for documentation?▼

You do not need a Confluence MCP configured to run the documentation search. The tool gracefully handles cases where Confluence MCP is not configured by entering a dry-run mode instead of failing.

How are Confluence search results ranked when looking up task context?▼

Confluence search results are ranked by relevance scoring based on keyword matches, page recency, and project context. This ensures the most applicable documentation links are appended to your task YAML.

What happens if Confluence search is not working or configured for my project?▼

If Confluence search is not working because the MCP is not configured, the tool enters a dry-run mode to gracefully handle the missing dependency. This prevents task execution failure while still processing your task context YAML.