agentmods.dev

flux-topology

flux-topology is a skill for Claude Code, Codex from seppaleinen/flux-topology-mcp. It costs 31 tokens per session (704 once invoked), scanned A, original, MIT.

A repository map for FluxCD, a tool that keeps Kubernetes applications in sync from Git. It builds a graph showing applications, shared resources, and their relationships.

In plain words
What is it for?
Use it to explore applications, trace dependencies, find shared-resource references, check possible impact, and review topology changes.
Why use it?
It helps you understand an unfamiliar GitOps repository and see what could be affected before changing or removing an application.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

not rated 0repo changed 1mo ago A scan 31 tokens original MIT

Good fit Use it to explore applications, trace dependencies, find shared-resource references, check possible impact, and review topology changes.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/seppaleinen/flux-topology-mcp/flux-topology
View source ↗ seppaleinen/flux-topology-mcp
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add seppaleinen/flux-topology-mcp --skill flux-topology
Clone the repo
git clone --depth 1 https://github.com/seppaleinen/flux-topology-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for flux-topology

README.md
[![agentmods](https://agentmods.dev/badge/skills/seppaleinen/flux-topology-mcp/flux-topology/github.svg)](https://agentmods.dev/skills/seppaleinen/flux-topology-mcp/flux-topology)
Your own site
<a href="https://agentmods.dev/skills/seppaleinen/flux-topology-mcp/flux-topology"><img src="https://agentmods.dev/badge/skills/seppaleinen/flux-topology-mcp/flux-topology/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for flux-topology

Your own site · 80×15
<a href="https://agentmods.dev/skills/seppaleinen/flux-topology-mcp/flux-topology"><img src="https://agentmods.dev/badge/skills/seppaleinen/flux-topology-mcp/flux-topology.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 704 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00031 $0.00704
Opus 5.5 $0.00012 $0.00282
Sonnet 5.5 $0.00006 $0.00141
Haiku 4.5 $0.00003 $0.00070

Measured 1mo ago against content hash 943238561a88, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

flux-topology scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/flux-topology/SKILL.md · 77 lines

How it starts

The opening of the file, as written. The whole thing — 77 lines — stays where its author put it; the contents beside it link to each section on GitHub.

flux-topology

A CLI + skill that builds a dependency and topology graph of a FluxCD GitOps repository by static analysis.

When to use

  • Debugging or exploring a FluxCD/Kubernetes GitOps repo
  • Understanding blast radius before deleting or modifying an app
  • Finding all references to a shared resource (Helm chart, image, config)
  • Onboarding to an unfamiliar Flux repository
  • Reviewing topology changes in a PR

Prerequisites

pip install flux-topology
npx skills add seppaleinen/flux-topology-mcp   # this skill

No MCP server is required — flux-topology is a plain CLI.

READ FIRST (no binary needed)

Prefer the cache files directly — they are greppable and cheap:

  1. .fluxtop/apps/*.md — one human-readable markdown card per App (workloads, services, ingress hosts, depends-on/referenced-by, warnings). Grep or open these for per-app detail.
  2. .fluxtop/wiring.json — the machine-readable graph. Use targeted jq queries (e.g. jq '.apps[].id' .fluxtop/wiring.json) as needed. NEVER dump the whole file — it is large and expensive.

Computed queries (binary)

Use the CLI only for queries that need computation over the whole graph:

Command Purpose
flux-topology map Overview: domains, hub apps by edge count, warnings
flux-topology trace <app> BFS blast radius with typed edges
flux-topology find-refs <pattern> Regex search for references across all apps
flux-topology app-card <app> Full card for one app
flux-topology check-freshness Check if the cache is fresh/stale/absent (never rebuilds)

Trace options: --direction out|in|both (default out) and --depth N (default 5). All commands accept [dir] (default .) and --json for machine-readable output.

Build on change

flux-topology build [dir] [--force]

Run build when the repo was moved, after YAML changes, or when a STALE notice appears. Query commands auto-build only when there is no cache at all; a STALE cache is surfaced as a notice with exit code 1 — rebuild before trusting the results.

Read the full file on GitHub · 77 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +12 lines 943238561a88
  2. 2mo ago First seen · 65 lines · 31 tokens per session scan A 15157b75947f

Subscribe to this mod's changes

flux-topology is a skill published in the GitHub repository seppaleinen/flux-topology-mcp (0 stars, last pushed 5d ago), licensed MIT. It adds 31 tokens to every session and 704 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

CloudDevOps and cloud
Related

flux-topology compared with skills from other repositories

flux-topology next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
flux-topologyseppaleinen/flux-topology-mcpSkill05d agoMITA31Claude Code, Codex
gke-compute-classesgoogle/skillsSkill22kyesterdayApache-2.0A83Claude Code, Codex
gke-reliabilitygoogle/skillsSkill22kyesterdayApache-2.0A85Claude Code, Codex
gke-workload-securitygoogle/skillsSkill22kyesterdayApache-2.0A171Claude Code, Codex
cloud-architectJeffallan/claude-skillsSkill12k7d agoMITA71Claude Code
nemo-automodel-launcher-configNVIDIA/skillsSkill3.9kyesterdayApache-2.0A30Claude Code
azure-mgmt-botservice-dotnetmicrosoft/skillsSkill3.2kyesterdayMITA78Claude Code