Agent skill

Libreqos Python Workflow

by LibreQoE in LibreQoE/LibreQoS

Shared LibreQoS workflow for Python orchestration, scheduler, integrations, and helper scripts under src/.

GPL-2.0Auto-check passed

Install Libreqos Python Workflow

skills CLI
$ npx skills add LibreQoE/LibreQoS --skill libreqos-python-workflow -a claude-code

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

GitHub CLI
$ gh skill install LibreQoE/LibreQoS libreqos-python-workflow --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/LibreQoE/LibreQoS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/libreqos-python-workflow .claude/skills/libreqos-python-workflow && 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
libreqos-python-workflow
GitHub stars
718
Token cost
~1.1k tokens
SKILL.md length
453 words
Files
4 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
GPL-2.0

At a glance

Shared LibreQoS workflow for Python orchestration, scheduler, integrations, and helper scripts under src/.

  • Changing LibreQoS.py
  • SKILL.md covers Scope, Architecture, Invariants and Validation, plus 3 more sections
  • Calls python3
  • IntegrationCommon.py

What it does

Libreqos Python Workflow is an agent skill from LibreQoE/LibreQoS. Shared LibreQoS workflow for Python orchestration, scheduler, integrations, and helper scripts under src/. Use when changing LibreQoS.py, scheduler.py, integration.py, integrationCommon.py, Python helpers, or Python tests around shaping and generated config files.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/generated-runtime-files.md` and `references/integration-modes.md`).

It works with Python. The repository describes itself as: Self-hosted traffic management and network operations platform for ISPs. Use CAKE and fqcodel to reduce bufferbloat, enforce bandwidth plans, and troubleshoot congestion with… The licence is GPL-2.0.

When your agent uses it

  • Changing LibreQoS.py
  • IntegrationCommon.py
  • Python tests around shaping and generated config files

Example prompts

  • “/libreqos-python-workflow”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 3eeaf94. 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

    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

Libreqos Python Workflow loads about 1.1k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 453 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from LibreQoE/LibreQoS at commit 3eeaf94, republished under its GPL-2.0 licence (© LibreQoE). 453 words, ~1,086 tokens.

Download SKILL.mdSave it as .claude/skills/libreqos-python-workflow/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
libreqos-python-workflow
description
Shared LibreQoS workflow for Python orchestration, scheduler, integrations, and helper scripts under src/. Use when changing LibreQoS.py, scheduler.py, integration*.py, integrationCommon.py, Python helpers, or Python tests around shaping and generated config files.

LibreQoS Python Workflow

Use this skill for Python work under src/.

Scope

  • Main Python shaper entrypoint: src/LibreQoS.py
  • Scheduler/orchestration: src/scheduler.py
  • Shared importer graph/output logic: src/integrationCommon.py
  • Importers and helper scripts: src/integration*.py, src/lqTools.py, src/configMigrator.py, src/csvToNetworkJSON.py, src/cidrToHosts.py, src/mikrotikFindIPv6.py
  • Python tests: src/test_*.py, src/bakery_integration_test.py, src/testGraph.py

Architecture

  • LibreQoS.py is the live shaper/orchestrator. It validates inputs, builds queueing state, coordinates TC/XDP work through liblqos_python, and writes runtime artifacts such as queuingStructure.json, statsByCircuit.json, and statsByParentNode.json.
  • scheduler.py runs integrations, applies overrides, updates scheduler status for the Web UI, and triggers full or partial refreshes.
  • integrationCommon.py is the shared graph/output layer for integrations and writes network.json and ShapedDevices.csv.
  • Python in this repo is operational glue around liblqos_python and installed runtime files, not an isolated app package.

Invariants

  • Do not require a venv. System-Python compatibility is intentional.
  • Treat ShapedDevices.csv and network.json as shared contracts across integrations, scheduler, overrides, and shaping.
  • Preserve stable circuit and device identities emitted by integrations unless the change explicitly includes a migration plan for overrides and downstream consumers.
  • Preserve tolerant input handling for operator-managed files: BOMs, UTF-16/non-UTF8 CSVs, comment stripping, and uneven rows are all present in current workflows for a reason.
  • Preserve scheduler resilience: importer failures should be logged/reported and should not kill the scheduler loop.
  • Preserve existing external protocols and identity values for integrations unless the task explicitly includes coordinated changes on both sides.
  • Be careful with paths: some code uses get_libreqos_directory(), while some helpers and tests intentionally use cwd-relative files.
Show full SKILL.md (218 more words)Show less

Validation

  • Run targeted tests from src/, not repo root, for example:
    • python3 -m unittest test_scheduler.py
    • python3 -m unittest test_shaping_skip_report.py
    • python3 -m unittest test_virtual_tree_nodes.py
  • If changing scheduler/helpers, prefer the smallest focused unittest set that covers the touched logic.
  • If changing generated file behavior, review both the writer and the reader side in the same change.
  • After any repo change, invoke heckler via $libreqos-review-subagents-workflow before returning to the user.
  • After each source-code implementation batch, also invoke reaper via $libreqos-review-subagents-workflow.
  • During large sessions, invoke $libreqos-review-subagents-workflow (and helen if UI changed).

References

  • Read references/generated-runtime-files.md when deciding whether a file is source input, generated output, or runtime state.
  • Read references/integration-modes.md when touching scheduler/importer selection, stable identities, or integration output assumptions.

High-Risk Changes

  • Anything that changes ShapedDevices.csv columns, row semantics, or encoding behavior
  • Anything that changes network.json structure or virtual-node handling
  • Scheduler subprocess/error-handling behavior
  • Runtime path handling or current-working-directory assumptions
  • Live shaping entrypoints that can touch TC/XDP state
  • Broad "cleanup" refactors that try to package-ize or normalize the Python tree

Notes

  • ispConfig.py is useful as a historical/example config reference, but current runtime config is largely surfaced through liblqos_python and /etc/lqos.conf.
  • Historical files such as LibreQoS-old.py, LibreQoS-ancient.py, and LibreQoS.py.new exist in-tree but are not the default source of truth.
  • If a Python change adds or newly requires shipped files, update src/build_dpkg.sh in the same change.

© LibreQoE, GPL-2.0. 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 3 other files (references) in .agents/skills/libreqos-python-workflow of LibreQoE/LibreQoS.

  • SKILL.md
  • agents/openai.yaml
  • references/generated-runtime-files.md
  • references/integration-modes.md

Open the folder on GitHubat commit 3eeaf94

Compare with similar skills

Libreqos Python Workflow 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.

Libreqos Python Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Libreqos Python Workflow this skillLibreQoE/LibreQoS718—~1.1kAutomated safety check: PassGPL-2.0
MCP Server Builderanthropics/skills180k62 repos~2.3kAutomated safety check: PassApache-2.0
PDF Processinganthropics/skills180k48 repos~2kAutomated safety check: PassProprietary
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k13 repos~2.4kAutomated safety check: NotesMIT
Manim Video Productionbrowser-use/video-use28k6 repos~3kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 62 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • PDF Processing

    anthropics/skills

    Official

    Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.

    180k GitHub starsUsed in 48 repos~2k tokens
    Documents & OfficeAuto-check passed
  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 13 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    28k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    58k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed

More from LibreQoE/LibreQoS

All 8 skills in this repo
  • Project workflow for invoking the local review sub-agents Thomas, Helen, Beck, Jonas, The Reaper, and Heckler during LibreQoS coding sessions.

    718 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Libreqos Anti Slop

    LibreQoE/LibreQoS

    Anti-slop workflow for LibreQoS. An agent skill from LibreQoE/LibreQoS.

    718 GitHub stars~820 tokensUpdated 4 days ago
    Auto-check passed
  • Shared LibreQoS workflow for packaging, release, and shipped-file changes.

    718 GitHub stars~781 tokensUpdated 4 days ago
    Auto-check passed
  • Libreqos Git Workflow

    LibreQoE/LibreQoS

    Shared LibreQoS git workflow. An agent skill from LibreQoE/LibreQoS.

    718 GitHub stars~479 tokensUpdated 4 days ago
    Auto-check passed
  • Libreqos Lqos Sys Ebpf

    LibreQoE/LibreQoS

    Shared LibreQoS workflow for lqossys eBPF, C wrapper, bindgen, and pinned-map ABI work.

    718 GitHub stars~793 tokensUpdated 4 days ago
    Auto-check passed
  • Shared LibreQoS workflow for nodemanager frontend work. An agent skill from LibreQoE/LibreQoS.

    718 GitHub stars~915 tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Libreqos Python Workflow

What does Libreqos Python Workflow do?

Shared LibreQoS workflow for Python orchestration, scheduler, integrations, and helper scripts under src/. Libreqos Python Workflow is an agent skill from LibreQoE/LibreQoS. Shared LibreQoS workflow for Python orchestration, scheduler, integrations, and helper scripts under src/.

When should I use Libreqos Python Workflow?

Libreqos Python Workflow fits situations like: changing LibreQoS.py; integrationCommon.py; Python tests around shaping and generated config files.

How do I install Libreqos Python Workflow in Claude Code?

Run `npx skills add LibreQoE/LibreQoS --skill libreqos-python-workflow -a claude-code`. Or copy the skill folder (.agents/skills/libreqos-python-workflow in LibreQoE/LibreQoS) into .claude/skills/libreqos-python-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Libreqos Python Workflow in Codex?

Run `npx skills add LibreQoE/LibreQoS --skill libreqos-python-workflow -a codex`. Or copy the skill folder (.agents/skills/libreqos-python-workflow in LibreQoE/LibreQoS) into .agents/skills/libreqos-python-workflow in your project. Codex loads it when a task matches its description.

Can I use Libreqos Python Workflow 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 LibreQoE/LibreQoS --skill libreqos-python-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/libreqos-python-workflow, .gemini/skills/libreqos-python-workflow, .github/skills/libreqos-python-workflow and .opencode/skills/libreqos-python-workflow in your project.

What does Libreqos Python Workflow need to run?

Going by SKILL.md and its folder, Libreqos Python Workflow needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Libreqos Python Workflow 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 Libreqos Python Workflow 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. Review the folder before installing.

What licence does Libreqos Python Workflow use?

Libreqos Python Workflow is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Libreqos Python Workflow use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 666 tokens, read only when the agent opens those files.

What are the alternatives to Libreqos Python Workflow?

Skills that share tags, products or a category with Libreqos Python Workflow: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Libreqos Python Workflow?

LibreQoE (a GitHub organization) maintains it in LibreQoE/LibreQoS, which has 718 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 4, 2026.

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