From 1e4b62c89aa8b1b357e7d7b5fc9a05bb7c828a69 Mon Sep 17 00:00:00 2001 From: Ciro Xu Date: Thu, 26 Mar 2026 17:03:35 +0800 Subject: [PATCH] fix(docs): correct search examples in SKILL.md to use --cql flag The search examples showed raw CQL passed as a plain query string (e.g. `confluence search "type=page AND space=MYSPACE"`), but without the `--cql` flag this is treated as a literal text search, not a CQL query. Also document the `--cql` option in the command reference and use `siteSearch ~` which works more reliably on Confluence Server/DC. Co-Authored-By: Claude Opus 4.6 (1M context) --- .claude/skills/confluence/SKILL.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/.claude/skills/confluence/SKILL.md b/.claude/skills/confluence/SKILL.md index 6db733a..63470eb 100644 --- a/.claude/skills/confluence/SKILL.md +++ b/.claude/skills/confluence/SKILL.md @@ -197,16 +197,17 @@ confluence find "API Reference" --space MYSPACE Search pages using a keyword or CQL expression. ```sh -confluence search [--limit ] +confluence search [--limit ] [--cql] ``` | Option | Default | Description | |---|---|---| | `--limit` | `10` | Maximum number of results | +| `--cql` | false | Pass query as raw CQL instead of text search | ```sh confluence search "deployment pipeline" -confluence search "type=page AND space=MYSPACE" --limit 50 +confluence search --cql 'siteSearch ~ "deployment pipeline" and space = "MYSPACE"' --limit 50 ``` --- @@ -697,7 +698,7 @@ confluence children 123456789 --recursive --format json | jq '.[].id' ### Search and process results ```sh -confluence search "release notes" --limit 20 +confluence search --cql 'siteSearch ~ "release notes" and space = "MYSPACE"' --limit 20 ``` ---