slk-shared

Files (1)

• SKILL.md

SKILL.md (first lines)

# slk — Shared Reference

PREREQUISITE for every `slk-<group>` skill. Covers discovery, global flags, and the rules that apply to all commands.

## Discovering Commands

- `slk --help` — all command groups.
- `slk <group> --help` — a group's verbs.
- `slk <group> <verb> --help` — a verb's flags.

## Global Flags

| Flag | Default | Description |
|------|---------|-------------|
| `--as` | — | identity user\|bot: on a command, assert the active token's scope; on 'auth login', which token to mint (default user) |
| `--dry-run` | — | validate without calling the API |
| `--format` | `concise` | output format: concise\|json\|jsonl\|table |
| `--no-resolve` | — | do not resolve IDs to names |
| `--profile` | — | config profile to use |
| `--raw` | — | return raw Slack API response |

## Security Rules

- Never print or log token strings.
- Confirm with the user before any write/destructive command; preview with `--dry-run`.
- Write verbs honor `--raw` (return raw Slack JSON) and `--dry-run` (print the about-to-fire call and return without hitting the API).

## Exit Codes

`0` ok · `3` auth · `4` not found · `5` rate-limited · `1` other.

## Shell Tips

- `--params` takes a flat JSON object; single-quote it so the shell keeps the inner double quotes (`--params '{"k":"v"}'`). Nested values must be pre-serialized JSON strings.
- Shell `"\n"` is literal — for multi-line text use `--text-file` / `--markdown-file` (`-` for stdin).

From howar31/slk, MIT.

More from howar31/slk