Slack admin cli skill
sladm — Slack Admin CLI for humans and AI agents. Manage Enterprise Grid via admin.* APIs.
npx -y skills add yamitzky/slack-admin-cli --skill slack-admin-cli-skillAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Slack Admin CLI (`sladm`) を使って Slack Admin API / SCIM API / 標準 Slack API を操作する。 チーム管理・ユーザー管理・チャンネル管理・アプリ管理・ワークフロー管理・招待リクエスト管理・関数管理・SCIMユーザー/グループ管理・ 認証ポリシー・情報バリア・絵文字・ロール・ユーザーグループ管理に加え、非 admin API(users.info, users.profile, conversations.list/info/members, usergroups CRUD, team.info/profile/billableInfo/accessLogs/integrationLogs)も利用可能。 Slack ワークスペースの管理・情報取得操作を行いたいときに使う。
SKILL.md
5.4 KB, as published. Nobody here has run it
Slack Admin CLI (sladm)
Slack Enterprise Grid / Business+ ワークスペースの管理 CLI。
admin.* スコープの API に加え、標準の users.* / conversations.* / usergroups.* / team.* API も利用可能。
Web UI では面倒な一括操作・情報取得・スクリプト化が可能。
CLI の使い方を調べる
CLI はセルフドキュメンティング。推測せず、必ず --help で確認すること。
sladm --help # トップレベルのコマンド一覧
sladm conversations --help # conversations グループのサブコマンド一覧
sladm conversations search --help # 個別コマンドのオプション詳細
インストール
# Bun でグローバルインストール
bun link
# または直接実行
bun run src/index.ts
認証
# プロファイルにトークンを登録(キーチェーンに保存)
sladm token add <PROFILE_NAME> <xoxp-...>
# 登録済みプロファイル一覧
sladm token list
# トークンの有効性を確認
sladm token status
admin コマンドには admin.* スコープが必要。非 admin コマンド(users.info, conversations.list 等)は標準スコープ(users:read, channels:read, usergroups:read, team:read 等)で利用可能。
環境変数 SLADM_PROFILE でデフォルトプロファイルを指定可能。
出力形式
すべてのコマンドで3種類の出力形式をサポート:
--json— JSON 形式(パイプ処理向き)--plain— タブ区切りテキスト(TSV、スクリプト向き)- デフォルト — 整形済みテーブル表示
プロファイル切り替え
sladm --profile production teams list
sladm --profile staging users list
コマンドグループ
| グループ | 用途 | レシピ |
|---|---|---|
token | プロファイル・トークン管理 | — |
teams | チーム作成・設定・管理者一覧 | teams |
users | ユーザー招待・昇格・セッション管理 | users |
conversations | チャンネル操作・一括処理・アクセス制御 | conversations |
apps | アプリ承認・制限・設定 | apps |
invite-requests | ワークスペース招待の承認・拒否 | invite-requests |
workflows | ワークフロー検索・権限・コラボレーター | workflows |
functions | カスタム関数の一覧・権限設定 | functions |
scim-users | SCIM ユーザー管理(作成・更新・無効化) | scim-users |
scim-groups | SCIM グループ管理(作成・更新・削除) | scim-groups |
auth-policy | 認証ポリシーへのエンティティ割り当て | — |
barriers | 情報バリア(Information Barriers)の作成・更新・削除 | — |
emoji | カスタム絵文字の追加・エイリアス・リネーム・削除 | — |
roles | システムロール割り当ての追加・一覧・削除 | — |
usergroups | ユーザーグループのチーム・デフォルトチャンネル管理、CRUD(非 admin) | — |
新規グループの使用例
レシピ未整備のグループについては --help で詳細を確認すること。代表的な例:
# カスタム絵文字一覧
sladm emoji list --json
# カスタム絵文字追加(URL 指定)
sladm emoji add --name party-parrot --url https://example.com/parrot.gif
# 情報バリア一覧
sladm barriers list
# ロール割り当て一覧(例: チャンネル管理者 ロール)
sladm roles list-assignments --role-id Rl0A
# ユーザーグループにデフォルトチャンネルを追加
sladm usergroups add-channels --usergroup-id S123 --team-id T123 --channel-ids C1,C2
# 認証ポリシーにエンティティを割り当て
sladm auth-policy assign-entities --policy-name email_password --entity-type user --entity-ids U1,U2
トラブルシューティング
Token not found:sladm token addでトークンを登録するnot_authed/invalid_auth: トークンが無効。sladm token statusで確認missing_scope: トークンに必要なスコープがない。admin コマンドにはadmin.*、非 admin コマンドにはusers:read,channels:read,usergroups:read,team:read等が必要not_an_admin: Enterprise Grid / Business+ の管理者権限が必要- 配列パラメータ: カンマ区切りで指定(例:
--channel-ids C1,C2,C3)