Halo cli auth

Use when working with Halo CLI authentication, login, bearer token or basic auth, profile setup, profile switching, current profile inspection, or fixing missing keyring credentials. Trigger this skill whenever the user needs to log into Halo, manage Halo CLI profiles, switch profiles, or diagnose authentication issues.From its SKILL.md

Install

npx -y skills add halo-dev/cli --skill halo-cli-auth

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

runs commandsInstructs the agent to run 8 commands, including `halo auth --help` and 7 more.
fetches URLsInstructs the agent to fetch 2 URLs, including http://127.0.0.1:8090 and 1 more.

SKILL.md

2.5 KB, 533 tokens by cl100k_base, as published. Nobody here has run it

Halo CLI Auth

Use this skill for halo auth and halo auth profile.

If authentication is not set up yet, do this first before running post, single-page, plugin, theme, attachment, backup, moment, comment, or notification commands.

Commands

halo auth --help
halo auth login --help
halo auth profile --help

Main workflows:

halo auth login
halo auth current
halo auth profile list
halo auth profile current
halo auth profile get <name>
halo auth profile use <name>
halo auth profile delete <name>
halo auth profile doctor

Common Flows

halo auth login \
  --profile local \
  --url http://127.0.0.1:8090 \
  --auth-type bearer \
  --token <token>

halo auth login \
  --profile local \
  --url http://127.0.0.1:8090 \
  --auth-type basic \
  --username admin \
  --password <password>

Inspect and switch profiles:

halo auth current
halo auth profile list
halo auth profile use production
halo auth profile get production --json

Diagnose broken credentials:

halo auth profile doctor
halo auth profile delete production --force
halo auth login --profile production --url https://halo.example.com --auth-type bearer --token <token>

Rules

In non-interactive mode, halo auth login requires --profile, --url, and --auth-type.
basic auth requires --username and --password.
bearer auth requires --token.
Use --json when another tool needs structured output.
profile delete is destructive; use --force in non-interactive mode.
Profile metadata lives in config, but secrets live in the system keyring.

Routing

Use halo-cli-content for posts and single pages.
Use halo-cli-search for public site search.
Use halo-cli-operations for themes, plugins, attachments, backups, and moments.
Use halo-cli-moderation-notifications for comments, replies, and notifications.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.