loudmouth-ai 0.1.0 → 0.2.0

package/skills/discord/SKILL.md

@@ -1,475 +0,0 @@
----
-name: discord
-description: Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, create/edit/delete channels and categories, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
-metadata: {"clawdbot":{"emoji":"🎮","requires":{"config":["channels.discord"]}}}
----
-
-# Discord Actions
-
-## Overview
-
-Use `discord` to manage messages, reactions, threads, polls, and moderation. You can disable groups via `discord.actions.*` (defaults to enabled, except roles/moderation). The tool uses the bot token configured for Clawdbot.
-
-## Inputs to collect
-
-- For reactions: `channelId`, `messageId`, and an `emoji`.
-- For fetchMessage: `guildId`, `channelId`, `messageId`, or a `messageLink` like `https://discord.com/channels/<guildId>/<channelId>/<messageId>`.
-- For stickers/polls/sendMessage: a `to` target (`channel:<id>` or `user:<id>`). Optional `content` text.
-- Polls also need a `question` plus 2–10 `answers`.
-- For media: `mediaUrl` with `file:///path` for local files or `https://...` for remote.
-- For emoji uploads: `guildId`, `name`, `mediaUrl`, optional `roleIds` (limit 256KB, PNG/JPG/GIF).
-- For sticker uploads: `guildId`, `name`, `description`, `tags`, `mediaUrl` (limit 512KB, PNG/APNG/Lottie JSON).
-
-Message context lines include `discord message id` and `channel` fields you can reuse directly.
-
-**Note:** `sendMessage` uses `to: "channel:<id>"` format, not `channelId`. Other actions like `react`, `readMessages`, `editMessage` use `channelId` directly.
-**Note:** `fetchMessage` accepts message IDs or full links like `https://discord.com/channels/<guildId>/<channelId>/<messageId>`.
-
-## Actions
-
-### React to a message
-
-```json
-{
-  "action": "react",
-  "channelId": "123",
-  "messageId": "456",
-  "emoji": "✅"
-}
-```
-
-### List reactions + users
-
-```json
-{
-  "action": "reactions",
-  "channelId": "123",
-  "messageId": "456",
-  "limit": 100
-}
-```
-
-### Send a sticker
-
-```json
-{
-  "action": "sticker",
-  "to": "channel:123",
-  "stickerIds": ["9876543210"],
-  "content": "Nice work!"
-}
-```
-
-- Up to 3 sticker IDs per message.
-- `to` can be `user:<id>` for DMs.
-
-### Upload a custom emoji
-
-```json
-{
-  "action": "emojiUpload",
-  "guildId": "999",
-  "name": "party_blob",
-  "mediaUrl": "file:///tmp/party.png",
-  "roleIds": ["222"]
-}
-```
-
-- Emoji images must be PNG/JPG/GIF and <= 256KB.
-- `roleIds` is optional; omit to make the emoji available to everyone.
-
-### Upload a sticker
-
-```json
-{
-  "action": "stickerUpload",
-  "guildId": "999",
-  "name": "clawdbot_wave",
-  "description": "Clawdbot waving hello",
-  "tags": "👋",
-  "mediaUrl": "file:///tmp/wave.png"
-}
-```
-
-- Stickers require `name`, `description`, and `tags`.
-- Uploads must be PNG/APNG/Lottie JSON and <= 512KB.
-
-### Create a poll
-
-```json
-{
-  "action": "poll",
-  "to": "channel:123",
-  "question": "Lunch?",
-  "answers": ["Pizza", "Sushi", "Salad"],
-  "allowMultiselect": false,
-  "durationHours": 24,
-  "content": "Vote now"
-}
-```
-
-- `durationHours` defaults to 24; max 32 days (768 hours).
-
-### Check bot permissions for a channel
-
-```json
-{
-  "action": "permissions",
-  "channelId": "123"
-}
-```
-
-## Ideas to try
-
-- React with ✅/⚠️ to mark status updates.
-- Post a quick poll for release decisions or meeting times.
-- Send celebratory stickers after successful deploys.
-- Upload new emojis/stickers for release moments.
-- Run weekly “priority check” polls in team channels.
-- DM stickers as acknowledgements when a user’s request is completed.
-
-## Action gating
-
-Use `discord.actions.*` to disable action groups:
-- `reactions` (react + reactions list + emojiList)
-- `stickers`, `polls`, `permissions`, `messages`, `threads`, `pins`, `search`
-- `emojiUploads`, `stickerUploads`
-- `memberInfo`, `roleInfo`, `channelInfo`, `voiceStatus`, `events`
-- `roles` (role add/remove, default `false`)
-- `channels` (channel/category create/edit/delete/move, default `false`)
-- `moderation` (timeout/kick/ban, default `false`)
-### Read recent messages
-
-```json
-{
-  "action": "readMessages",
-  "channelId": "123",
-  "limit": 20
-}
-```
-
-### Fetch a single message
-
-```json
-{
-  "action": "fetchMessage",
-  "guildId": "999",
-  "channelId": "123",
-  "messageId": "456"
-}
-```
-
-```json
-{
-  "action": "fetchMessage",
-  "messageLink": "https://discord.com/channels/999/123/456"
-}
-```
-
-### Send/edit/delete a message
-
-```json
-{
-  "action": "sendMessage",
-  "to": "channel:123",
-  "content": "Hello from Clawdbot"
-}
-```
-
-**With media attachment:**
-
-```json
-{
-  "action": "sendMessage",
-  "to": "channel:123",
-  "content": "Check out this audio!",
-  "mediaUrl": "file:///tmp/audio.mp3"
-}
-```
-
-- `to` uses format `channel:<id>` or `user:<id>` for DMs (not `channelId`!)
-- `mediaUrl` supports local files (`file:///path/to/file`) and remote URLs (`https://...`)
-- Optional `replyTo` with a message ID to reply to a specific message
-
-```json
-{
-  "action": "editMessage",
-  "channelId": "123",
-  "messageId": "456",
-  "content": "Fixed typo"
-}
-```
-
-```json
-{
-  "action": "deleteMessage",
-  "channelId": "123",
-  "messageId": "456"
-}
-```
-
-### Threads
-
-```json
-{
-  "action": "threadCreate",
-  "channelId": "123",
-  "name": "Bug triage",
-  "messageId": "456"
-}
-```
-
-```json
-{
-  "action": "threadList",
-  "guildId": "999"
-}
-```
-
-```json
-{
-  "action": "threadReply",
-  "channelId": "777",
-  "content": "Replying in thread"
-}
-```
-
-### Pins
-
-```json
-{
-  "action": "pinMessage",
-  "channelId": "123",
-  "messageId": "456"
-}
-```
-
-```json
-{
-  "action": "listPins",
-  "channelId": "123"
-}
-```
-
-### Search messages
-
-```json
-{
-  "action": "searchMessages",
-  "guildId": "999",
-  "content": "release notes",
-  "channelIds": ["123", "456"],
-  "limit": 10
-}
-```
-
-### Member + role info
-
-```json
-{
-  "action": "memberInfo",
-  "guildId": "999",
-  "userId": "111"
-}
-```
-
-```json
-{
-  "action": "roleInfo",
-  "guildId": "999"
-}
-```
-
-### List available custom emojis
-
-```json
-{
-  "action": "emojiList",
-  "guildId": "999"
-}
-```
-
-### Role changes (disabled by default)
-
-```json
-{
-  "action": "roleAdd",
-  "guildId": "999",
-  "userId": "111",
-  "roleId": "222"
-}
-```
-
-### Channel info
-
-```json
-{
-  "action": "channelInfo",
-  "channelId": "123"
-}
-```
-
-```json
-{
-  "action": "channelList",
-  "guildId": "999"
-}
-```
-
-### Channel management (disabled by default)
-
-Create, edit, delete, and move channels and categories. Enable via `discord.actions.channels: true`.
-
-**Create a text channel:**
-
-```json
-{
-  "action": "channelCreate",
-  "guildId": "999",
-  "name": "general-chat",
-  "type": 0,
-  "parentId": "888",
-  "topic": "General discussion"
-}
-```
-
-- `type`: Discord channel type integer (0 = text, 2 = voice, 4 = category; other values supported)
-- `parentId`: category ID to nest under (optional)
-- `topic`, `position`, `nsfw`: optional
-
-**Create a category:**
-
-```json
-{
-  "action": "categoryCreate",
-  "guildId": "999",
-  "name": "Projects"
-}
-```
-
-**Edit a channel:**
-
-```json
-{
-  "action": "channelEdit",
-  "channelId": "123",
-  "name": "new-name",
-  "topic": "Updated topic"
-}
-```
-
-- Supports `name`, `topic`, `position`, `parentId` (null to remove from category), `nsfw`, `rateLimitPerUser`
-
-**Move a channel:**
-
-```json
-{
-  "action": "channelMove",
-  "guildId": "999",
-  "channelId": "123",
-  "parentId": "888",
-  "position": 2
-}
-```
-
-- `parentId`: target category (null to move to top level)
-
-**Delete a channel:**
-
-```json
-{
-  "action": "channelDelete",
-  "channelId": "123"
-}
-```
-
-**Edit/delete a category:**
-
-```json
-{
-  "action": "categoryEdit",
-  "categoryId": "888",
-  "name": "Renamed Category"
-}
-```
-
-```json
-{
-  "action": "categoryDelete",
-  "categoryId": "888"
-}
-```
-
-### Voice status
-
-```json
-{
-  "action": "voiceStatus",
-  "guildId": "999",
-  "userId": "111"
-}
-```
-
-### Scheduled events
-
-```json
-{
-  "action": "eventList",
-  "guildId": "999"
-}
-```
-
-### Moderation (disabled by default)
-
-```json
-{
-  "action": "timeout",
-  "guildId": "999",
-  "userId": "111",
-  "durationMinutes": 10
-}
-```
-
-## Discord Writing Style Guide
-
-**Keep it conversational!** Discord is a chat platform, not documentation.
-
-### Do
-- Short, punchy messages (1-3 sentences ideal)
-- Multiple quick replies > one wall of text
-- Use emoji for tone/emphasis 🦞
-- Lowercase casual style is fine
-- Break up info into digestible chunks
-- Match the energy of the conversation
-
-### Don't
-- No markdown tables (Discord renders them as ugly raw `| text |`)
-- No `## Headers` for casual chat (use **bold** or CAPS for emphasis)
-- Avoid multi-paragraph essays
-- Don't over-explain simple things
-- Skip the "I'd be happy to help!" fluff
-
-### Formatting that works
-- **bold** for emphasis
-- `code` for technical terms
-- Lists for multiple items
-- > quotes for referencing
-- Wrap multiple links in `<>` to suppress embeds
-
-### Example transformations
-
-❌ Bad:
-```
-I'd be happy to help with that! Here's a comprehensive overview of the versioning strategies available:
-
-## Semantic Versioning
-Semver uses MAJOR.MINOR.PATCH format where...
-
-## Calendar Versioning
-CalVer uses date-based versions like...
-```
-
-✅ Good:
-```
-versioning options: semver (1.2.3), calver (2026.01.04), or yolo (`latest` forever). what fits your release cadence?
-```

package/skills/eightctl/SKILL.md

@@ -1,29 +0,0 @@
----
-name: eightctl
-description: Control Eight Sleep pods (status, temperature, alarms, schedules).
-homepage: https://eightctl.sh
-metadata: {"clawdbot":{"emoji":"🎛️","requires":{"bins":["eightctl"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/eightctl/cmd/eightctl@latest","bins":["eightctl"],"label":"Install eightctl (go)"}]}}
----
-
-# eightctl
-
-Use `eightctl` for Eight Sleep pod control. Requires auth.
-
-Auth
-- Config: `~/.config/eightctl/config.yaml`
-- Env: `EIGHTCTL_EMAIL`, `EIGHTCTL_PASSWORD`
-
-Quick start
-- `eightctl status`
-- `eightctl on|off`
-- `eightctl temp 20`
-
-Common tasks
-- Alarms: `eightctl alarm list|create|dismiss`
-- Schedules: `eightctl schedule list|create|update`
-- Audio: `eightctl audio state|play|pause`
-- Base: `eightctl base info|angle`
-
-Notes
-- API is unofficial and rate-limited; avoid repeated logins.
-- Confirm before changing temperature or alarms.

package/skills/food-order/SKILL.md

@@ -1,41 +0,0 @@
----
-name: food-order
-description: Reorder Foodora orders + track ETA/status with ordercli. Never confirm without explicit user approval. Triggers: order food, reorder, track ETA.
-homepage: https://ordercli.sh
-metadata: {"clawdbot":{"emoji":"🥡","requires":{"bins":["ordercli"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/ordercli/cmd/ordercli@latest","bins":["ordercli"],"label":"Install ordercli (go)"}]}}
----
-
-# Food order (Foodora via ordercli)
-
-Goal: reorder a previous Foodora order safely (preview first; confirm only on explicit user “yes/confirm/place the order”).
-
-Hard safety rules
-- Never run `ordercli foodora reorder ... --confirm` unless user explicitly confirms placing the order.
-- Prefer preview-only steps first; show what will happen; ask for confirmation.
-- If user is unsure: stop at preview and ask questions.
-
-Setup (once)
-- Country: `ordercli foodora countries` → `ordercli foodora config set --country AT`
-- Login (password): `ordercli foodora login --email you@example.com --password-stdin`
-- Login (no password, preferred): `ordercli foodora session chrome --url https://www.foodora.at/ --profile "Default"`
-
-Find what to reorder
-- Recent list: `ordercli foodora history --limit 10`
-- Details: `ordercli foodora history show <orderCode>`
-- If needed (machine-readable): `ordercli foodora history show <orderCode> --json`
-
-Preview reorder (no cart changes)
-- `ordercli foodora reorder <orderCode>`
-
-Place reorder (cart change; explicit confirmation required)
-- Confirm first, then run: `ordercli foodora reorder <orderCode> --confirm`
-- Multiple addresses? Ask user for the right `--address-id` (take from their Foodora account / prior order data) and run:
-  - `ordercli foodora reorder <orderCode> --confirm --address-id <id>`
-
-Track the order
-- ETA/status (active list): `ordercli foodora orders`
-- Live updates: `ordercli foodora orders --watch`
-- Single order detail: `ordercli foodora order <orderCode>`
-
-Debug / safe testing
-- Use a throwaway config: `ordercli --config /tmp/ordercli.json ...`

package/skills/gemini/SKILL.md

@@ -1,23 +0,0 @@
----
-name: gemini
-description: Gemini CLI for one-shot Q&A, summaries, and generation.
-homepage: https://ai.google.dev/
-metadata: {"clawdbot":{"emoji":"♊️","requires":{"bins":["gemini"]},"install":[{"id":"brew","kind":"brew","formula":"gemini-cli","bins":["gemini"],"label":"Install Gemini CLI (brew)"}]}}
----
-
-# Gemini CLI
-
-Use Gemini in one-shot mode with a positional prompt (avoid interactive mode).
-
-Quick start
-- `gemini "Answer this question..."`
-- `gemini --model <name> "Prompt..."`
-- `gemini --output-format json "Return JSON"`
-
-Extensions
-- List: `gemini --list-extensions`
-- Manage: `gemini extensions <command>`
-
-Notes
-- If auth is required, run `gemini` once interactively and follow the login flow.
-- Avoid `--yolo` for safety.

package/skills/gifgrep/SKILL.md

@@ -1,47 +0,0 @@
----
-name: gifgrep
-description: Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
-homepage: https://gifgrep.com
-metadata: {"clawdbot":{"emoji":"🧲","requires":{"bins":["gifgrep"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gifgrep","bins":["gifgrep"],"label":"Install gifgrep (brew)"},{"id":"go","kind":"go","module":"github.com/steipete/gifgrep/cmd/gifgrep@latest","bins":["gifgrep"],"label":"Install gifgrep (go)"}]}}
----
-
-# gifgrep
-
-Use `gifgrep` to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
-
-GIF-Grab (gifgrep workflow)
-- Search → preview → download → extract (still/sheet) for fast review and sharing.
-
-Quick start
-- `gifgrep cats --max 5`
-- `gifgrep cats --format url | head -n 5`
-- `gifgrep search --json cats | jq '.[0].url'`
-- `gifgrep tui "office handshake"`
-- `gifgrep cats --download --max 1 --format url`
-
-TUI + previews
-- TUI: `gifgrep tui "query"`
-- CLI still previews: `--thumbs` (Kitty/Ghostty only; still frame)
-
-Download + reveal
-- `--download` saves to `~/Downloads`
-- `--reveal` shows the last download in Finder
-
-Stills + sheets
-- `gifgrep still ./clip.gif --at 1.5s -o still.png`
-- `gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png`
-- Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
-- Tune: `--frames` (count), `--cols` (grid width), `--padding` (spacing).
-
-Providers
-- `--source auto|tenor|giphy`
-- `GIPHY_API_KEY` required for `--source giphy`
-- `TENOR_API_KEY` optional (Tenor demo key used if unset)
-
-Output
-- `--json` prints an array of results (`id`, `title`, `url`, `preview_url`, `tags`, `width`, `height`)
-- `--format` for pipe-friendly fields (e.g., `url`)
-
-Environment tweaks
-- `GIFGREP_SOFTWARE_ANIM=1` to force software animation
-- `GIFGREP_CELL_ASPECT=0.5` to tweak preview geometry

package/skills/github/SKILL.md

@@ -1,48 +0,0 @@
----
-name: github
-description: "Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries."
-metadata: {"clawdbot":{"emoji":"🐙","requires":{"bins":["gh"]},"install":[{"id":"brew","kind":"brew","formula":"gh","bins":["gh"],"label":"Install GitHub CLI (brew)"},{"id":"apt","kind":"apt","package":"gh","bins":["gh"],"label":"Install GitHub CLI (apt)"}]}}
----
-
-# GitHub Skill
-
-Use the `gh` CLI to interact with GitHub. Always specify `--repo owner/repo` when not in a git directory, or use URLs directly.
-
-## Pull Requests
-
-Check CI status on a PR:
-```bash
-gh pr checks 55 --repo owner/repo
-```
-
-List recent workflow runs:
-```bash
-gh run list --repo owner/repo --limit 10
-```
-
-View a run and see which steps failed:
-```bash
-gh run view <run-id> --repo owner/repo
-```
-
-View logs for failed steps only:
-```bash
-gh run view <run-id> --repo owner/repo --log-failed
-```
-
-## API for Advanced Queries
-
-The `gh api` command is useful for accessing data not available through other subcommands.
-
-Get PR with specific fields:
-```bash
-gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
-```
-
-## JSON Output
-
-Most commands support `--json` for structured output.  You can use `--jq` to filter:
-
-```bash
-gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
-```