AI Assistant Skills

Teach your AI coding assistant how to use the Flowbot CLI. Skills follow the SKILL.md convention and work with Claude Code, opencode, and other AI tools.

What Are Skills?

Skills are instruction files that teach AI assistants how to interact with the flowbot CLI. Each skill describes a Flowbot capability — its full command tree, flags, common workflows, and troubleshooting tips.

When you ask an AI assistant to "save this URL" or "create a kanban card", the assistant loads the corresponding skill and follows the documented commands to get the job done.

How Skills Work

1. Auto-Discovery

The AI assistant reads each skill's name and description from SKILL.md YAML frontmatter at startup.

2. Smart Trigger

When your request matches a skill's description keywords, the assistant loads the full SKILL.md into context.

3. Executed via CLI

The assistant follows the documented commands, flags, and workflows to compose and run the right flowbot command.

Enabling Skills

Flowbot skills are generated into docs/skills/. To use them with your AI assistant, symlink the skill directories into the tool's skills path:

Claude Code

# Project-wide
mkdir -p .claude/skills/
ln -sf "$(pwd)/docs/skills/homelab-bookmark" .claude/skills/homelab-bookmark
ln -sf "$(pwd)/docs/skills/homelab-kanban"    .claude/skills/homelab-kanban
ln -sf "$(pwd)/docs/skills/homelab-reader"    .claude/skills/homelab-reader

# Global
mkdir -p ~/.claude/skills/
ln -sf "$(pwd)/docs/skills/homelab-bookmark" ~/.claude/skills/homelab-bookmark

opencode

Configure your opencode environment to scan docs/skills/ as a skills directory.

Available Skills

Flowbot ships with three production skills. Each skill is auto-generated from the live CLI command tree and kept in sync with the codebase.

homelab-bookmark Bookmark Management

Create, list, search, archive, and tag bookmarks stored in the Flowbot server. Triggers on keywords like bookmarks, saving URLs, link collection, reading list.

Key Commands

Command Description
flowbot bookmark create -u <url> Add a new bookmark
flowbot bookmark list List all bookmarks
flowbot bookmark get <id> Get bookmark details
flowbot bookmark search -q <q> Full-text search
flowbot bookmark check-url -u <url> Check if URL is bookmarked
flowbot bookmark archive <id> Archive / unarchive
flowbot bookmark delete <id> Delete a bookmark

Common Workflows

  • Save a URL: check-url → create → report details
  • Find bookmarks: search → get → present results
View full SKILL.md 
name:          homelab-bookmark
triggers:      bookmarks, saving URLs, link collection, web
               clippings, reading list, tagging URLs, URL
               archiving, checking saved links
capabilities:  create, list, get, search, check-url, archive,
               delete
support:       flags: --url, --query, --sort-order, --limit,
               --cursor, --include-content, --yes

homelab-kanban Kanban Task Management

Manage kanban boards and tasks. Create, update, move, and search tasks. Handle subtasks with time tracking, tags, columns, and metadata. Triggers on kanban, task management, todo list, time tracking, moving cards.

Key Commands

Command Description
flowbot kanban list -s active List active tasks
flowbot kanban get <id> Get task details
flowbot kanban create -t "title" Create a task
flowbot kanban move <id> -c <col> Move to column
flowbot kanban search <query> Search tasks
flowbot kanban subtask list <id> List subtasks
flowbot kanban subtask create <id> -t "s" -e 30 Create subtask with estimate
flowbot kanban subtask timer start <tid> <sid> Start time tracking
flowbot kanban tag create -n <name> Create tag
flowbot kanban metadata set <id> key=val Set metadata

Common Workflows

  • Create with subtasks: column list → create → subtask create (repeat)
  • Review and triage: list -s active → get → subtask list → summarize & suggest
View full SKILL.md 
name:          homelab-kanban
triggers:      kanban, task management, project management,
               kanban board, todo list, task tracking, issue
               tracking, subtasks, time tracking, moving cards,
               board columns, task tags
capabilities:  list, search, get, create, update, move, delete,
               card add/move/delete, column list, metadata
               get/set/delete, tag list/create/update/delete,
               tag task get/set, subtask list/get/create/update
               /delete, subtask timer start/stop/check/spent

homelab-reader RSS Feed Reader

Subscribe to RSS and Atom feeds. List entries, mark items read/unread, star entries, and manage feed lifecycle. Triggers on RSS feeds, feed reader, news feeds, Atom feeds, subscribing to blogs.

Key Commands

Command Description
flowbot reader list List all feeds
flowbot reader create -u <url> Add a new feed
flowbot reader get <id> Get feed details
flowbot reader refresh <id> Refresh a feed
flowbot reader entries -s unread -n 20 List unread entries
flowbot reader feed-entries <id> -n 5 Entries for a feed
flowbot reader update-entries -i <ids> -s read Mark entries read
flowbot reader update <id> --enable Enable a feed

Common Workflows

  • Subscribe to a feed: create → refresh → feed-entries → report latest
  • Catch up on unread: entries -s unread → present → update-entries -s read
View full SKILL.md 
name:          homelab-reader
triggers:      RSS feeds, RSS reader, feed reader, news feeds,
               Atom feeds, subscribing to blogs, reading feeds,
               feed management, marking read, starring articles
capabilities:  list, get, create, update, refresh, entries,
               update-entries, feed-entries
support:       flags: --url, --category, --title, --disable,
               --enable, --status, --limit, --offset, --starred,
               --ids

Generating Skills

Skills are auto-generated from the live CLI command tree using the Flowbot composer tool. This ensures every skill stays in sync with the actual CLI interface. 

# Regenerate all skills
go tool task build:composer
./flowbot-composer skills --output ./docs/skills

Adding a New Skill

To add a new skill, implement the CLI command tree in cmd/cli/command/, then register the capability in cmd/composer/action/skills/skills.go with its name, description, trigger keywords, and workflows. Re-run the generator to produce the new SKILL.md.

File Format

Each skill is a directory under docs/skills/ containing a single SKILL.md file: 

docs/skills/homelab-bookmark/
├── SKILL.md

SKILL.md structure:
  ├── YAML frontmatter (name, description)
  ├── Prerequisites & global flags
  ├── Operations (auto-generated from CLI tree)
  ├── Common workflows (hand-written recipes)
  └── Troubleshooting

Next Steps