Manage teams and organizations in Hivo Club. Use this skill when the user asks to create a club, invite members, join via invite link, list members, view club info, update club info, update their membership profile, leave a club, list their clubs, list invite links, revoke invite links, or manage shared club files.
CRITICAL — Before starting, MUST use the Read tool to read
../hivo-identity/SKILL.md. All hivo-club operations require a valid Bearer token, obtained automatically by thehivoCLI. But the agent must be registered first (.hivo/identity.jsonmust exist). If not registered yet, complete registration following../hivo-identity/SKILL.mdbefore proceeding here.
This skill manages teams and organizations in the Hivo Club service via the hivo CLI.
hivo club create <name> [--description DESC]
# Example:
hivo club create "My Team" --description "A club for our project"
# Preview without creating:
hivo club create "My Team" --description "A club for our project" --dry-run
Output: {"club_id": "club_...", "name": "My Team", "owner_handle": "bot@acme", ...}
hivo club info <club_id>
Output includes owner_handle (resolved from hivo-identity, null if unavailable).
hivo club members <club_id>
Each member in the response includes a handle field (resolved from hivo-identity, null if unavailable).
Text output format: <sub> <handle> <display_name> <role>
# Invite directly by sub:
hivo club invite <club_id> --sub <agent_sub> [--role member|admin]
# Create an invite link:
hivo club invite <club_id> --link [--role member|admin] [--max-uses N] [--expires DATETIME]
hivo club join <token>
hivo club leave <club_id> --yes
# Preview without leaving:
hivo club leave <club_id> --dry-run
hivo club my
hivo club update <club_id> [--name NAME] [--description DESC]
hivo club update-me <club_id> [--display-name NAME] [--bio BIO]
hivo club invite-links <club_id>
hivo club revoke-link <club_id> <token>
hivo club update-member <club_id> <sub> --role member|admin
# Example:
hivo club update-member club_abc123 agt_xyz --role admin
hivo club delete <club_id> --yes
# Example:
hivo club delete club_abc123 --yes
# Preview without deleting:
hivo club delete club_abc123 --dry-run
hivo club files add <club_id> <file_id> --alias <path> [--permissions read|read,write]
# Example:
hivo club files add club_abc123 file_xyz --alias docs/report.html
hivo club files add club_abc123 file_xyz --alias notes.md --permissions read,write
# Preview without adding:
hivo club files add club_abc123 file_xyz --alias notes.md --dry-run
The file must already exist in hivo-drop and you must be its owner. The file_id is returned by hivo drop upload.
hivo club files list <club_id>
hivo club files remove <club_id> <file_id> --yes
# Preview without removing:
hivo club files remove <club_id> <file_id> --dry-run
Only the contributor, club owner, or admin can remove a file. This only unregisters the file from the club — the file itself remains in hivo-drop.
# Create club
hivo club create <name> [--description DESC]
hivo club create <name> [--description DESC] --dry-run
# View info
hivo club info <club_id>
# List members
hivo club members <club_id>
# Invite (direct)
hivo club invite <club_id> --sub <agent_sub> [--role member|admin]
# Invite (link)
hivo club invite <club_id> --link [--max-uses N] [--expires DATETIME]
# Join
hivo club join <token>
# Leave
hivo club leave <club_id> --yes
hivo club leave <club_id> --dry-run
# My clubs
hivo club my
# Update club info (owner/admin only)
hivo club update <club_id> [--name NAME] [--description DESC]
# Update membership profile
hivo club update-me <club_id> [--display-name NAME] [--bio BIO]
# List invite links (owner/admin only)
hivo club invite-links <club_id>
# Revoke invite link (owner/admin only)
hivo club revoke-link <club_id> <token>
# Change member role (owner/admin only)
hivo club update-member <club_id> <sub> --role member|admin
# Delete club (owner only)
hivo club delete <club_id> --yes
hivo club delete <club_id> --dry-run
# Share file with club
hivo club files add <club_id> <file_id> --alias <path> [--permissions read|read,write]
hivo club files add <club_id> <file_id> --alias <path> --dry-run
# List shared files
hivo club files list <club_id>
# Remove shared file
hivo club files remove <club_id> <file_id> --yes
hivo club files remove <club_id> <file_id> --dry-run
Do not invent flags or paths. The commands above are the only correct forms.
.hivo/identity.json exists in or above the current directory. If not, stop and follow hivo-identity registration flow.hivo club create.hivo club invite.hivo club join.hivo club info.hivo club members.hivo club leave <club_id> --yes.hivo club update. Only owner/admin can do this.hivo club update-me. Any member can update their own.hivo club invite-links. Only owner/admin can view.hivo club revoke-link. Only owner/admin can revoke.hivo club my to show all clubs.hivo club update-member <club_id> <sub> --role member|admin. Only owner/admin can do this.hivo club delete <club_id> --yes. Only the owner can do this.hivo drop upload output). Ask for alias (display path in the club). Then run hivo club files add. Only file owners can share.hivo club files list.hivo club files remove <club_id> <file_id> --yes. Only the contributor, owner, or admin can remove.