Agent skill

Coordinator Source Of Truth

by kubefleet-dev in kubefleet-dev/kubefleet

The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules…

Apache-2.0Auto-check passedAgent Workflows

Install Coordinator Source Of Truth

skills CLI
$ npx skills add kubefleet-dev/kubefleet --skill coordinator-source-of-truth -a claude-code

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

GitHub CLI
$ gh skill install kubefleet-dev/kubefleet coordinator-source-of-truth --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/kubefleet-dev/kubefleet.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/coordinator-source-of-truth .claude/skills/coordinator-source-of-truth && 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
coordinator-source-of-truth
GitHub stars
162
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
572 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules…

  • Works in 4 steps: If squad.agent.md and any other file… → Append-only files must never be… → Agents may only write to files listed in… → …
  • Agent Workflows work in your project
  • SKILL.md covers State backend note, File hierarchy and Rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Coordinator Source Of Truth is an agent skill from kubefleet-dev/kubefleet. The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. The repository describes itself as: KubeFleet is an open-source Kubernetes multi-cluster application management solution. The licence is Apache-2.0.

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “who owns this file”
  • “/coordinator-source-of-truth”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. If squad.agent.md and any other file conflict, squad.agent.md wins. It is the only file with hard governance authority.
  2. Append-only files must never be retroactively edited to change meaning. They are diagnostic and audit-trail material. Corrections go in a…
  3. Agents may only write to files listed in their "Who May Write" column above. Violations are a contract bug; runtime state-backends will…
  4. Non-coordinator agents may propose decisions in their responses, but only Squad (Coordinator) records accepted decisions in…

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Coordinator Source Of Truth loads about 1.5k tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 572 words of instructions outside code blocks.

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

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 kubefleet-dev/kubefleet at commit 58812a2, republished under its Apache-2.0 licence (© kubefleet-dev). 572 words, ~1,474 tokens.

Download SKILL.mdSave it as .claude/skills/coordinator-source-of-truth/SKILL.md (or your agent's skills folder).
name
coordinator-source-of-truth
description
The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question.
confidence
high
domain
squad-internals
source
Extracted from squad.agent.md as part of the slimming effort (bradygaster/squad#1308). Behaviour unchanged — coordinator loads this satellite skill when a…

Load this skill when: the coordinator (or any agent) needs to resolve a "where does this state belong?" or "who is allowed to write this file?" question — e.g., when about to write .squad/decisions.md, when reviewing whether an agent broke the append-only rule, when answering a user question about Squad's file layout, or when adjudicating a conflict between two files. The short summary in squad.agent.md is for routing; this skill is the full reference.

State backend note

Files below marked as "Derived / append-only" are mutable state — agents access them with runtime state tools (squad_state_read, squad_state_write, squad_state_append, squad_state_delete, squad_state_list). The runtime decides whether the configured backend stores them on disk, git-native state, or an external provider. Files marked as "Authoritative" are static config and always live on disk regardless of backend.

File hierarchy

FileStatusWho May WriteWho May Read
.github/agents/squad.agent.mdAuthoritative governance. All roles, handoffs, gates, and enforcement rules.Repo maintainer (human)Squad (Coordinator)
.squad/decisions.mdAuthoritative decision ledger. Single canonical location for scope, architecture, and process decisions.Squad (Coordinator) — append onlyAll agents
.squad/team.mdAuthoritative roster. Current team composition.Squad (Coordinator)All agents
.squad/routing.mdAuthoritative routing. Work assignment rules.Squad (Coordinator)Squad (Coordinator)
.squad/ceremonies.mdAuthoritative ceremony config. Definitions, triggers, and participants for team ceremonies.Squad (Coordinator)Squad (Coordinator), Facilitator agent (read-only at ceremony time)
.squad/casting/policy.jsonAuthoritative casting config. Universe allowlist and capacity.Squad (Coordinator)Squad (Coordinator)
.squad/casting/registry.jsonAuthoritative name registry. Persistent agent-to-name mappings.Squad (Coordinator)Squad (Coordinator)
.squad/casting/history.jsonDerived / append-only. Universe usage history and assignment snapshots.Squad (Coordinator) — append onlySquad (Coordinator)
.squad/agents/{name}/charter.mdAuthoritative agent identity. Per-agent role and boundaries.Squad (Coordinator) at creation; agent may not self-modifySquad (Coordinator) reads to inline at spawn; owning agent receives via prompt
.squad/agents/{name}/history.mdDerived / append-only. Personal learnings. Never authoritative for enforcement.Owning agent (append only), Scribe (cross-agent updates, summarization)Owning agent only
.squad/agents/{name}/history-archive.mdDerived / append-only. Archived history entries. Preserved for reference.ScribeOwning agent (read-only)
.squad/orchestration-log/Derived / append-only. Agent routing evidence. Never edited after write.ScribeAll agents (read-only)
.squad/log/Derived / append-only. Session logs. Diagnostic archive. Never edited after write.ScribeAll agents (read-only)
.squad/templates/Reference. Format guides for runtime files. Not authoritative for enforcement.Squad (Coordinator) at initSquad (Coordinator)
.squad/rai/policy.mdAuthoritative RAI policy. Check categories, terminology standards, and opt-out rules.Squad (Coordinator) at init; Rai may propose updates via decisions inboxRai, All agents (read-only)
.squad/rai/audit-trail.mdDerived / append-only. RAI review evidence log. Redacted — never contains raw secrets or harmful content.Rai (append only)Rai, Squad (Coordinator)
.squad/fact-checker/policy.mdAuthoritative verification + Devil's Advocate policy. Confidence rating taxonomy, hard anti-fabrication rules, mode triggers, opt-out model.Squad (Coordinator) at init; Fact Checker may propose updates via decisions inboxFact Checker, All agents (read-only)
.squad/fact-checker/audit-trail.mdDerived / append-only. Verification verdicts + DA brief evidence log. Succinct — verdict + citation, never raw source material.Fact Checker (append only)Fact Checker, Squad (Coordinator)
.squad/plugins/marketplaces.jsonAuthoritative plugin config. Registered marketplace sources.Squad CLI (squad plugin marketplace)Squad (Coordinator)
Show full SKILL.md (95 more words)Show less

Rules

  1. If squad.agent.md and any other file conflict, squad.agent.md wins. It is the only file with hard governance authority.
  2. Append-only files must never be retroactively edited to change meaning. They are diagnostic and audit-trail material. Corrections go in a new entry that references the prior one.
  3. Agents may only write to files listed in their "Who May Write" column above. Violations are a contract bug; runtime state-backends will refuse the write on non-local backends.
  4. Non-coordinator agents may propose decisions in their responses, but only Squad (Coordinator) records accepted decisions in .squad/decisions.md.

© kubefleet-dev, Apache-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

Just SKILL.md in .github/skills/coordinator-source-of-truth of kubefleet-dev/kubefleet.

Open the folder on GitHubat commit 58812a2

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in kubefleet-dev/kubefleet, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Coordinator Source Of Truth 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.

Coordinator Source Of Truth compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Coordinator Source Of Truth this skillkubefleet-dev/kubefleet1621 repos~1.5kAutomated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0

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 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 35 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    297k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

More from kubefleet-dev/kubefleet

All 11 skills in this repo
  • Cross Squad

    kubefleet-dev/kubefleet

    Coordinating work across multiple Squad instances — discovery, delegation, and disambiguation when the user says 'squad' (the product) vs casual English 'group of agents'.

    162 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Iterative Retrieval

    kubefleet-dev/kubefleet

    Max-3-cycle protocol for agent sub-tasks with WHY context and coordinator validation.

    162 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Coordinator Response Mode

    kubefleet-dev/kubefleet

    Selecting WHO handles work is the Routing table; selecting HOW they handle it (Direct, Lightweight, Standard, Full) is Response Mode.

    162 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Cross Squad Communication

    kubefleet-dev/kubefleet

    Protocol for sending queries, delegating tasks, and sharing context between independent Squad instances across different repositories

    162 GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Reflect

    kubefleet-dev/kubefleet

    Learning capture system that extracts HIGH/MED/LOW confidence patterns from conversations to prevent repeating mistakes.

    162 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Squad

    kubefleet-dev/kubefleet

    Squad's command catalog and interactive menu. An agent skill from kubefleet-dev/kubefleet.

    162 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Categories

Questions about Coordinator Source Of Truth

What does Coordinator Source Of Truth do?

The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules…. Coordinator Source Of Truth is an agent skill from kubefleet-dev/kubefleet. The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-only, who may write each one, who may read each one, and the precedence rules when they conflict.

When should I use Coordinator Source Of Truth?

Coordinator Source Of Truth fits situations like: agent Workflows work in your project.

How do I install Coordinator Source Of Truth in Claude Code?

Run `npx skills add kubefleet-dev/kubefleet --skill coordinator-source-of-truth -a claude-code`. Or copy the skill folder (.github/skills/coordinator-source-of-truth in kubefleet-dev/kubefleet) into .claude/skills/coordinator-source-of-truth in your project. Claude Code loads it when a task matches its description.

How do I install Coordinator Source Of Truth in Codex?

Run `npx skills add kubefleet-dev/kubefleet --skill coordinator-source-of-truth -a codex`. Or copy the skill folder (.github/skills/coordinator-source-of-truth in kubefleet-dev/kubefleet) into .agents/skills/coordinator-source-of-truth in your project. Codex loads it when a task matches its description.

Can I use Coordinator Source Of Truth 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 kubefleet-dev/kubefleet --skill coordinator-source-of-truth -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/coordinator-source-of-truth, .gemini/skills/coordinator-source-of-truth, .github/skills/coordinator-source-of-truth and .opencode/skills/coordinator-source-of-truth in your project.

What does Coordinator Source Of Truth need to run?

SKILL.md names no scripts, command-line tools or credentials: Coordinator Source Of Truth is instructions for the agent only.

Does Coordinator Source Of Truth 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 Coordinator Source Of Truth 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 Coordinator Source Of Truth use?

Coordinator Source Of Truth is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Coordinator Source Of Truth use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 Coordinator Source Of Truth?

Skills that share tags, products or a category with Coordinator Source Of Truth: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Coordinator Source Of Truth?

kubefleet-dev (a GitHub organization) maintains it in kubefleet-dev/kubefleet, which has 162 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 9, 2026.

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