{"id":"7d042d17-b659-46e6-aa37-255c182c00da","shortId":"Hnt6U7","kind":"skill","title":"halo-cli-shared","tagline":"Use when a task involves Halo CLI, Halo CMS command-line operations, or terminal-based Halo management. Also use when you need shared rules for profiles, JSON output, help discovery, config paths, and destructive actions. Trigger this skill whenever the user mentions 'halo', 'Hal","description":"# Halo CLI Shared\n\nStart here when the task says \"use Halo CLI\" but does not yet say whether it is auth, content, search, operations, or moderation.\n\n## Install And Verify\n\nInstall globally:\n\n```bash\nnpm install -g @halo-dev/cli\n```\n\nBinary name:\n\n```bash\nhalo\n```\n\nCheck version and top-level help:\n\n```bash\nhalo --version\nhalo --help\n```\n\n## Top-Level Areas\n\n- `auth`\n- `post`\n- `single-page`\n- `search`\n- `plugin`\n- `theme`\n- `attachment`\n- `backup`\n- `moment`\n- `comment`\n- `notification`\n- `completion <shell>` — Generate shell completion script (bash, zsh, fish, powershell)\n\n## Shared Rules\n\n- Most command areas require an authenticated profile.\n- Use `halo auth login` to create a profile.\n- Use `--profile <name>` when more than one profile exists.\n- Use `--json` when output is meant for automation or follow-up parsing.\n- In non-interactive mode, dangerous commands usually require `--force`.\n- Read `--help` before guessing flags for a specific command.\n\n## Public vs Authenticated\n\nMost areas require auth.\n\nThe main public workflow is `halo search`, which can use a direct site URL without login:\n\n```bash\nhalo search --keyword \"halo\" --url https://www.halo.run\n```\n\n## Config And Secrets\n\nProfile metadata is stored in:\n\n- `$HALO_CLI_CONFIG_DIR/config.json` if `HALO_CLI_CONFIG_DIR` is set\n- otherwise `$XDG_CONFIG_HOME/halo/config.json`\n- otherwise `~/.config/halo/config.json`\n\nCredentials are stored in the system keyring.\n\n## Routing\n\n- Use `halo-cli-auth` for login, current profile, profile list/use/delete, and credential repair.\n- Use `halo-cli-content` for posts and single pages.\n- Use `halo-cli-search` for public site search.\n- Use `halo-cli-operations` for themes, plugins, attachments, backups, and moments.\n- Use `halo-cli-moderation-notifications` for comments, replies, and notifications.","tags":["halo","cli","shared","halo-dev","agent-skills","agents","halo-cli","openclaw","skills"],"capabilities":["skill","source-halo-dev","skill-halo-cli-shared","topic-agent-skills","topic-agents","topic-halo","topic-halo-cli","topic-openclaw","topic-skills"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/halo-dev/cli/halo-cli-shared","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add halo-dev/cli","source_repo":"https://github.com/halo-dev/cli","install_from":"skills.sh"}},"qualityScore":"0.458","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 16 github stars · SKILL.md body (1,821 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:06:17.922Z","embedding":null,"createdAt":"2026-04-23T13:03:49.225Z","updatedAt":"2026-05-18T19:06:17.922Z","lastSeenAt":"2026-05-18T19:06:17.922Z","tsv":"'/.config/halo/config.json':243 '/cli':89 'action':41 'also':24 'area':109,136,193 'attach':118,293 'auth':71,110,143,195,256 'authent':139,191 'autom':164 'backup':119,294 'base':21 'bash':82,92,101,128,212 'binari':90 'check':94 'cli':3,11,52,62,228,233,255,269,279,288,300 'cms':13 'command':15,135,176,188 'command-lin':14 'comment':121,304 'complet':123,126 'config':37,219,229,234,240 'content':72,270 'creat':146 'credenti':244,264 'current':259 'danger':175 'destruct':40 'dev':88 'dir':235 'dir/config.json':230 'direct':207 'discoveri':36 'exist':156 'fish':130 'flag':184 'follow':167 'follow-up':166 'forc':179 'g':85 'generat':124 'global':81 'guess':183 'hal':50 'halo':2,10,12,22,49,51,61,87,93,102,104,142,201,213,216,227,232,254,268,278,287,299 'halo-cli-auth':253 'halo-cli-cont':267 'halo-cli-moderation-notif':298 'halo-cli-oper':286 'halo-cli-search':277 'halo-cli-shar':1 'halo-dev':86 'help':35,100,105,181 'home/halo/config.json':241 'instal':77,80,84 'interact':173 'involv':9 'json':33,158 'keyr':250 'keyword':215 'level':99,108 'line':16 'list/use/delete':262 'login':144,211,258 'main':197 'manag':23 'meant':162 'mention':48 'metadata':223 'mode':174 'moder':76,301 'moment':120,296 'name':91 'need':28 'non':172 'non-interact':171 'notif':122,302,307 'npm':83 'one':154 'oper':17,74,289 'otherwis':238,242 'output':34,160 'page':114,275 'pars':169 'path':38 'plugin':116,292 'post':111,272 'powershel':131 'profil':32,140,148,150,155,222,260,261 'public':189,198,282 'read':180 'repair':265 'repli':305 'requir':137,178,194 'rout':251 'rule':30,133 'say':59,67 'script':127 'search':73,115,202,214,280,284 'secret':221 'set':237 'share':4,29,53,132 'shell':125 'singl':113,274 'single-pag':112 'site':208,283 'skill':44 'skill-halo-cli-shared' 'source-halo-dev' 'specif':187 'start':54 'store':225,246 'system':249 'task':8,58 'termin':20 'terminal-bas':19 'theme':117,291 'top':98,107 'top-level':97,106 'topic-agent-skills' 'topic-agents' 'topic-halo' 'topic-halo-cli' 'topic-openclaw' 'topic-skills' 'trigger':42 'url':209,217 'use':5,25,60,141,149,157,205,252,266,276,285,297 'user':47 'usual':177 'verifi':79 'version':95,103 'vs':190 'whenev':45 'whether':68 'without':210 'workflow':199 'www.halo.run':218 'xdg':239 'yet':66 'zsh':129","prices":[{"id":"c19e575e-089c-4e67-bd6c-0a36a23ace29","listingId":"7d042d17-b659-46e6-aa37-255c182c00da","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"halo-dev","category":"cli","install_from":"skills.sh"},"createdAt":"2026-04-23T13:03:49.225Z"}],"sources":[{"listingId":"7d042d17-b659-46e6-aa37-255c182c00da","source":"github","sourceId":"halo-dev/cli/halo-cli-shared","sourceUrl":"https://github.com/halo-dev/cli/tree/main/skills/halo-cli-shared","isPrimary":false,"firstSeenAt":"2026-04-23T13:03:49.225Z","lastSeenAt":"2026-05-18T19:06:17.922Z"}],"details":{"listingId":"7d042d17-b659-46e6-aa37-255c182c00da","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"halo-dev","slug":"halo-cli-shared","github":{"repo":"halo-dev/cli","stars":16,"topics":["agent-skills","agents","halo","halo-cli","openclaw","skills"],"license":"mit","html_url":"https://github.com/halo-dev/cli","pushed_at":"2026-05-13T05:09:19Z","description":"CLI for Halo, Halo for Agents.","skill_md_sha":"af660f42b201fb96def3db2131e26b4bafe98315","skill_md_path":"skills/halo-cli-shared/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/halo-dev/cli/tree/main/skills/halo-cli-shared"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"halo-cli-shared","description":"Use when a task involves Halo CLI, Halo CMS command-line operations, or terminal-based Halo management. Also use when you need shared rules for profiles, JSON output, help discovery, config paths, and destructive actions. Trigger this skill whenever the user mentions 'halo', 'Halo CLI', or terminal operations for Halo CMS, even if the specific command area is not yet clear."},"skills_sh_url":"https://skills.sh/halo-dev/cli/halo-cli-shared"},"updatedAt":"2026-05-18T19:06:17.922Z"}}