$npx -y skills add halo-dev/cli --skill halo-cli-searchUse when searching public content on a Halo site with Halo CLI. This includes keyword search, site URL based search, result limits, or any search that does not require authenticated console access. Trigger this skill whenever the user wants to search a Halo site from the terminal
| 1 | # Halo CLI Search |
| 2 | |
| 3 | Use this skill for `halo search`. |
| 4 | |
| 5 | This is the main Halo CLI workflow that can run without authenticated console access when `--url` is provided. |
| 6 | |
| 7 | ## Command |
| 8 | |
| 9 | ```bash |
| 10 | halo search --help |
| 11 | ``` |
| 12 | |
| 13 | ## Common Flows |
| 14 | |
| 15 | Search with a direct public site URL: |
| 16 | |
| 17 | ```bash |
| 18 | halo search --keyword "halo" --url https://www.halo.run |
| 19 | ``` |
| 20 | |
| 21 | Search with the active or selected profile: |
| 22 | |
| 23 | ```bash |
| 24 | halo search --keyword "release notes" |
| 25 | halo search --keyword "release notes" --profile production |
| 26 | ``` |
| 27 | |
| 28 | Limit results and emit JSON: |
| 29 | |
| 30 | ```bash |
| 31 | halo search --keyword "plugin" --limit 5 --json |
| 32 | ``` |
| 33 | |
| 34 | ## Rules |
| 35 | |
| 36 | - `--keyword` is required. |
| 37 | - `--limit` must be a positive number. |
| 38 | - `--url` targets a public Halo site directly and avoids authenticated console access. |
| 39 | - If `--url` is omitted, Halo CLI resolves the base URL from the active or selected profile. |
| 40 | - Use `--json` when another tool needs to parse search results. |
| 41 | |
| 42 | ## Related Skills |
| 43 | |
| 44 | - Use `halo-cli-auth` if the task first needs a profile. |
| 45 | - Use `halo-cli-content` after search when the goal shifts to editing posts or pages. |