New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Fleet Helper

by Szotasz in Szotasz/marveen

Shared, dependency-free Python helpers for the agent fleet - dashboard API (memory, messages, kanban), Telegram MarkdownV2 escaping, and rule-based Mail.app triage.

MITAuto-check passedProductivity & Automation

Install Fleet Helper

skills CLI
$ npx skills add Szotasz/marveen --skill fleet-helper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Szotasz/marveen fleet-helper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Szotasz/marveen.git skills-src && mkdir -p .claude/skills && cp -r skills-src/seed-skills/fleet-helper .claude/skills/fleet-helper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fleet-helper
GitHub stars
117
Token cost
~1.7k tokens
SKILL.md length
813 words
Files
7 (incl. scripts)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Shared, dependency-free Python helpers for the agent fleet - dashboard API (memory, messages, kanban), Telegram MarkdownV2 escaping, and rule-based Mail.app triage.

  • Do deterministic work (fetch/filter/SQL/format/escape) in Python instead of burning model tokens doing it in the LLM turn
  • SKILL.md covers When to use, Scripts, Quick start and Kanban writes (comment / move…, plus 2 more sections
  • Runs Python scripts from its folder; calls python3
  • Tasks that involve Task management

What it does

Fleet Helper is an agent skill from Szotasz/marveen. Shared, dependency-free Python helpers for the agent fleet - dashboard API (memory, messages, kanban), Telegram MarkdownV2 escaping, and rule-based Mail.app triage. Use to do deterministic work (fetch/filter/SQL/format/escape) in Python instead of burning model tokens doing it in the LLM turn. The dashboard token is read from store/.dashboard-token at call time, never hardcoded.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `scripts/README.md`, `scripts/fleet.py` and `scripts/gate_example.py`).

It sits in Productivity & Automation, covering Task management and SQL. It works with Python, SQL and Telegram. The repository describes itself as: AI csapatod, ami fut amíg te alszol. The licence is MIT.

When your agent uses it

  • Do deterministic work (fetch/filter/SQL/format/escape) in Python instead of burning model tokens doing it in the LLM turn
  • Tasks that involve Task management
  • Tasks that involve SQL

Example prompts

  • “/fleet-helper”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit e1ac6cc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 6 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fleet Helper loads about 1.7k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 813 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Szotasz/marveen at commit e1ac6cc, republished under its MIT licence (© Szotasz). 813 words, ~1,685 tokens.

Download SKILL.mdSave it as .claude/skills/fleet-helper/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
fleet-helper
description
Shared, dependency-free Python helpers for the agent fleet - dashboard API (memory, messages, kanban), Telegram MarkdownV2 escaping, and rule-based Mail.app triage. Use to do deterministic work (fetch/filter/SQL/format/escape) in Python instead of burning model tokens doing it in the LLM turn. The dashboard token is read from store/.dashboard-token at call time, never hardcoded.

fleet-helper

Move deterministic work (fetch / filter / SQL / format / escape) out of the model and into Python, so heartbeats and scheduled tasks stop spending tokens re-deriving the same plumbing each cycle. Python 3 stdlib only, no pip deps.

No secrets or personal data are baked in: the dashboard token is read from store/.dashboard-token at call time, the project root comes from CLAW_DIR (or is auto-detected), and any personal sender/keyword lists live in a gitignored mail_rules.json (see scripts/mail_rules.example.json).

When to use

  • Saving/searching memory, posting daily-log, sending inter-agent messages.
  • Reading kanban (due today / stuck / by status) without writing SQL by hand.
  • Writing a kanban comment, move or field where scripts/kartya-es-ertesites.py refuses your agent (its roster is a literal; see "Kanban writes" below).
  • Escaping text for a Telegram MarkdownV2 message.
  • An email heartbeat: pre-filter unread mail to a compact JSON before the model reasons about it.
  • Building a token-cheap heartbeat gate (see "The heartbeat gate pattern" below).

Scripts

  • scripts/fleet.py - dashboard API + kanban read helpers + MarkdownV2 escaper (CLI and importable module).
    • KET escaper van, es a rossz valasztas nemitja a formazast (2026-08-28-i meres). mdv2 MINDENT escapel, a *-ot IS: az *felkover* markereidbol \*felkover\* lesz, tehat sima szoveg. Ez akkor helyes, ha PROGRAMBOL rakod ossze az uzenetet (escapeled a dinamikus reszt, aztan te teszed ra a *-ot). KEZZEL IRT hosszu uzenethez (reggeli napindito) mdv2b kell: az a *-ot meghagyja, minden mast escapel, ES kuldes elott lefuttatja az outgoing_gate_check-et (em dash, --, paratlan csillag). Ha talal valamit, exit 2 es NEM ad kimenetet.
  • scripts/mail_triage.py - rule-based unread Mail.app filter (macOS), JSON out, never sends and never marks read.
  • scripts/gate_example.py - reference heartbeat gate; its shell invocation IS the mandatory keep-alive tool call (the LLM turn is not skipped, just cheap).
  • scripts/mail_rules.example.json - copy to mail_rules.json (gitignored) with your real senders/keywords.
  • scripts/README.md - full usage and the heartbeat gate pattern write-up.

Quick start

🛑 USE A ../../-RELATIVE PATH, NOT A BARE RELATIVE PATH -- your shell's CWD is your own agent directory (<project-root>/agents/<name>/), NOT the repo root, so a bare relative path below resolves to nothing there. A sub-agent's CWD is always exactly two levels under the project root (agentDir() in src/web/agent-config.ts: PROJECT_ROOT/agents/<name>), so ../../ reaches the root from ANY agent, on ANY machine -- no hardcoded absolute path needed. ($CLAUDE_PROJECT_DIR, used elsewhere for hook command fields, does NOT help here: it is unset in a normal agent Bash call, measured empty.) (Bitten twice in one night, 2026-08-17: two fleet agents each ran a root-level find / -iname fleet.py trying to locate this script -- a 10+ minute runaway search under macOS/iCloud folders.)

bash
P=../../seed-skills/fleet-helper/scripts
python3 $P/fleet.py mdv2 "Tomorrow (8:00) - report!"   # escaped MarkdownV2 (kills *bold*)
cat brief.txt | python3 $P/fleet.py mdv2b            # keeps *bold*, refuses em dash / " -- "
python3 $P/fleet.py kanban-due
python3 $P/mail_triage.py 90                            # unread <= 90 min -> JSON
Show full SKILL.md (399 more words)Show less

Kanban writes (comment / move / set)

scripts/kartya-es-ertesites.py is the gated path for a card comment or a status move (accent gate, owner notification, the automated marker), and WHERE IT RUNS IT STAYS THE PATH. Its roster is a literal, though, so on an install whose agents are not in it every --author is refused. These three carry no roster: they send what the dashboard accepts, and they check nothing the gated tool checks.

bash
P=../../seed-skills/fleet-helper/scripts
python3 $P/fleet.py kanban-comment <id> <author> "<text>"       # or "-": the text from stdin
python3 $P/fleet.py kanban-move <id> <status> <actor>           # actor REQUIRED
python3 $P/fleet.py kanban-set <id> <field> <value> <actor>     # "null" clears; actor REQUIRED
  • The actor is not decoration. The move route uses it to suppress the "task assigned to you" echo when you move your own card; without it the move still answers {"ok":true} and the echo arrives later, costing a round. The PUT route writes it on the status-change audit event. A missing argument is a usage error (exit 2) and nothing is sent.
  • kanban-set writes ONE field per call: title, description, status, assignee, priority, project, parent_id, due_date, sort_order, archived_at. Any other field is a 400 naming the accepted ones, and the card is not touched. It is the only shipped way to due_date, project, parent_id and sort_order.
  • A move or a set here leaves NO comment. Where the reason matters, write the comment first.
  • The body is built with json.dumps from the arguments, so backticks and $(...) in a comment are text, never shell.

The heartbeat gate pattern (the high-value idea)

Frequent heartbeats often wake the model just to run deterministic checks and then stay silent - wasted tokens. Naively skipping the turn can be unsafe if your channel transport (e.g. a Telegram MCP over a stdio pipe) relies on a periodic local tool call to stay connected. The safe pattern: keep the turn but make it cheap - the heartbeat's first action runs a gate.py via the shell (that one Bash call IS the keep-alive), the gate does the deterministic checks and prints a has_signal flag; on false the model writes one line and stops, on true it only does the judgment + notification. Zero scheduler/runner changes. See scripts/README.md for the full rationale and two hard-won scheduling lessons (avoid cron collisions with other heartbeats; skipIfBusy trade-off).

Safety

  • Token is read from store/.dashboard-token at call time; never printed or committed.
  • The kanban READ helpers (due / stuck / status) are read-only SQL. The three WRITE commands go through the dashboard API with the token, like every other write here; prefer scripts/kartya-es-ertesites.py where your agent is on its roster.
  • mail_rules.json (your real senders) is gitignored.

© Szotasz, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts) in seed-skills/fleet-helper of Szotasz/marveen.

  • SKILL.md
  • scripts/.gitignore
  • scripts/README.md
  • scripts/fleet.py
  • scripts/gate_example.py
  • scripts/mail_rules.example.json
  • scripts/mail_triage.py

Open the folder on GitHubat commit e1ac6cc

Compare with similar skills

Fleet Helper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fleet Helper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fleet Helper this skillSzotasz/marveen117—~1.7kAutomated safety check: PassMIT
Chdb SQLvemetric/vemetric3951 repos~1.2kAutomated safety check: PassApache-2.0
Kolokoloai/kolo525—~1.2kAutomated safety check: PassNone
Coding Agentmastra-ai/mastra29k—~2.3kAutomated safety check: PassCustom licence
SQL Schema Policy Validatorrominirani/antigravity-skills592—~264Automated safety check: PassNone
Modelersidequery/sidemantic129—~4.2kAutomated safety check: PassApache-2.0

Similar skills

  • Chdb SQL

    vemetric/vemetric

    A skill your agent uses when the user wants to run SQL — especially analytical SQL — on local files (parquet/csv/json), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoDB, ClickHouse…

    395 GitHub starsUsed in 1 repo~1.2k tokens
    DatabasesAuto-check passed

  • Kolo

    koloai/kolo

    Kolo is a text-based Python debugger that captures every executed function, return value, local variable, HTTP request, and SQL query into greppable trace files.

    525 GitHub stars~1.2k tokensUpdated 5 mo ago
    DatabasesAuto-check passed

  • Coding Agent

    mastra-ai/mastra

    Authoring playbook for building agents that write, edit, review, or refactor code.

    29k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed

  • SQL Schema Policy Validator

    rominirani/antigravity-skills

    Validates SQL schema files for compliance with internal safety and naming policies.

    592 GitHub stars~264 tokensUpdated 3 mo ago
    DatabasesAuto-check passed

  • Modeler

    sidequery/sidemantic

    Build, validate, and manage semantic models using Sidemantic.

    129 GitHub stars~4.2k tokensUpdated 3 days ago
    DatabasesAuto-check passed

  • Analysis Artifacts

    warpdotdev/oz-skills

    Generate reproducible analysis artifacts — SQL queries, Python visualizations, and summary tables — as you work through a BigQuery data analysis.

    824 GitHub stars~1.1k tokensUpdated 1 mo ago
    DatabasesAuto-check passed

More from Szotasz/marveen

All 18 skills in this repo

  • GitHub PR Rebase Merge

    Szotasz/marveen

    Merge a stack of GitHub PRs sequentially when they share files and will cause cascading conflicts.

    117 GitHub stars~1.8k tokensUpdated today
    Auto-check passed

  • Handoff

    Szotasz/marveen

    Generate a HANDOFF.md context transfer document for session continuity.

    117 GitHub stars~1.5k tokensUpdated today
    Auto-check: notes

  • Retrospective

    Szotasz/marveen

    Analyze the current session for improvement opportunities in skills, memory, and workflow.

    117 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Bridge Szolgaltatas Lapok

    Szotasz/marveen

    A Marveen Bridge és a "Szolgáltatás-lapok" ajánlása és elmagyarázása a gazdának.

    117 GitHub stars~1.4k tokensUpdated today
    Auto-check: warnings

  • Skill Factory

    Szotasz/marveen

    Turn any workflow, conversation, or demonstrated process into a reusable SKILL.md.

    117 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • Skill Management

    Szotasz/marveen

    List, inspect, patch, or delete skills from ~/.claude/skills/.

    117 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Fleet Helper

What does Fleet Helper do?

Shared, dependency-free Python helpers for the agent fleet - dashboard API (memory, messages, kanban), Telegram MarkdownV2 escaping, and rule-based Mail.app triage. Fleet Helper is an agent skill from Szotasz/marveen.app triage.

When should I use Fleet Helper?

Fleet Helper fits situations like: do deterministic work (fetch/filter/SQL/format/escape) in Python instead of burning model tokens doing it in the LLM turn; tasks that involve Task management; tasks that involve SQL.

How do I install Fleet Helper in Claude Code?

Run `npx skills add Szotasz/marveen --skill fleet-helper -a claude-code`. Or copy the skill folder (seed-skills/fleet-helper in Szotasz/marveen) into .claude/skills/fleet-helper in your project. Claude Code loads it when a task matches its description.

How do I install Fleet Helper in Codex?

Run `npx skills add Szotasz/marveen --skill fleet-helper -a codex`. Or copy the skill folder (seed-skills/fleet-helper in Szotasz/marveen) into .agents/skills/fleet-helper in your project. Codex loads it when a task matches its description.

Can I use Fleet Helper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Szotasz/marveen --skill fleet-helper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fleet-helper, .gemini/skills/fleet-helper, .github/skills/fleet-helper and .opencode/skills/fleet-helper in your project.

What does Fleet Helper need to run?

Going by SKILL.md and its folder, Fleet Helper needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Fleet Helper access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fleet Helper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Fleet Helper use?

Fleet Helper is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fleet Helper use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fleet Helper?

Skills that share tags, products or a category with Fleet Helper: Chdb SQL (vemetric/vemetric, 395 stars), Kolo (koloai/kolo, 525 stars), Coding Agent (mastra-ai/mastra, 29k stars) and SQL Schema Policy Validator (rominirani/antigravity-skills, 592 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fleet Helper?

Szotasz (a GitHub user) maintains it in Szotasz/marveen, which has 117 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 10, 2026.

Source: Szotasz/marveen on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.