Agent skill

Repo Mirror Sources

by netdata in netdata/netdata

Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested.

GPL-3.0Auto-check: notesDevOps & Cloud

Install Repo Mirror Sources

skills CLI
$ npx skills add netdata/netdata --skill repo-mirror-sources -a claude-code

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

GitHub CLI
$ gh skill install netdata/netdata repo-mirror-sources --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/netdata/netdata.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/repo-mirror-sources .claude/skills/repo-mirror-sources && 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
repo-mirror-sources
GitHub stars
81k
Token cost
~1.2k tokens
SKILL.md length
513 words
Files
5 (incl. scripts)
Skills in repo
27
Repo updated
First seen
Licence
GPL-3.0

At a glance

Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested.

  • Cross-repo lookup
  • SKILL.md covers Choose the task, Inspect existing source, Maintenance boundary and Path discipline
  • Runs Shell and Python scripts from its folder; calls git and rg
  • Missing sources

What it does

Repo Mirror Sources is an agent skill from netdata/netdata. Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested. Use for cross-repo lookup, review, missing sources, mirror freshness, or scoped sync. Source inspection does not require syncing; maintenance can switch branches, pull, clone, and force-update submodules.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `how-tos/INDEX.md`, `maintenance.md` and `scripts/sync-netdata-repos.sh`).

It sits in DevOps & Cloud. It works with Git. The repository describes itself as: The fastest path to AI-powered full stack observability, even for lean teams. The licence is GPL-3.0.

When your agent uses it

  • Cross-repo lookup
  • Missing sources
  • Mirror freshness

Example prompts

  • “/repo-mirror-sources”

Requirements

  • Python 3
  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit a7f3cf9. 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 2 files in scripts/ (Shell and Python), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • rg

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Repo Mirror Sources loads about 1.2k tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 513 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:28
    `NETDATA_REPOS_DIR` and does not source `.env` itself. Set it explicitly

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 netdata/netdata at commit a7f3cf9, republished under its GPL-3.0 licence (© netdata). 513 words, ~1,175 tokens.

Download SKILL.mdSave it as .claude/skills/repo-mirror-sources/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
repo-mirror-sources
description
Inspect Netdata-org source checkouts under NETDATA_REPOS_DIR, or set up and synchronize that mirror when requested. Use for cross-repo lookup, review, missing sources, mirror freshness, or scoped sync. Source inspection does not require syncing; maintenance can switch branches, pull, clone, and force-update submodules.

Netdata source mirrors

Use existing local source checkouts for cross-repo search and review. This Netdata-org mirror is independent of other research mirrors. Its path is ${NETDATA_REPOS_DIR}; configuration is documented in .agents/ENV.md.

Choose the task

TaskRead / do
Inspect, compare, or review sourceUse the read-only route below; load relevant domain skills for the assigned lens
Establish whether local evidence is current enoughRecord checkout revision/state and the question's required revision; do not assume local means latest
Set up, refresh, or troubleshoot the mirrorRead maintenance.md before any sync; apply the scope already authorized by the task
Understand helper behaviorRead scripts/sync-netdata-repos.sh; its checks are not a general preservation guarantee
Capture a reusable mirror procedureFollow how-tos/INDEX.md and AGENTS.md#knowledge-capture

A request for cross-repo grep or review does not authorize sync, checkout, fetch, pull, clone, stash, commit, or push. A task that already authorizes maintenance needs no repeated permission for the same scope. Prefer named repository updates for a narrow maintenance request; full organization discovery is a distinct scope.

Inspect existing source

Resolve only the required configured path; do not print unrelated environment values or load credentials to grep local files. The helper reads an exported NETDATA_REPOS_DIR and does not source .env itself. Set it explicitly from the trusted project configuration when needed; maintenance setup is in maintenance.md.

For a known checkout such as learn, inspect its state before using it as evidence:

bash
: "${NETDATA_REPOS_DIR:?Set the configured mirror directory}"
mirror_repo="$NETDATA_REPOS_DIR/learn"
git --no-optional-locks -C "$mirror_repo" rev-parse HEAD
git --no-optional-locks -C "$mirror_repo" symbolic-ref --quiet --short HEAD || true
git --no-optional-locks -C "$mirror_repo" status --short --untracked-files=all --ignore-submodules=none
rg --files "$mirror_repo"

Use rg on the relevant files after locating them. A blank branch result may mean detached HEAD; a failed Git command is not a clean-state result. An available source checkout can be nested or use a .git file even though the sync helper only recognizes immediate repositories with .git directories.

Record the upstream owner/repository and exact checked commit under AGENTS.md#open-source-reference-evidence. Distinguish working-tree edits from committed source; do not attribute edited contents to an unmodified commit. Existing sources can answer questions about their recorded revision without a refresh. Check the requested revision when reviewing a PR or historical behavior; switching to default would discard the intended review context.

Show full SKILL.md (175 more words)Show less

If required sources are absent or freshness cannot be established, report that limit and determine whether the task already authorizes a scoped refresh or acquisition. Do not silently run the full sync to resolve one missing checkout. A current local timestamp, branch name, or old origin/HEAD reference does not prove live upstream freshness.

Maintenance boundary

The vendored helper performs existing-repository updates and optional organization discovery. It switches branches, fetches/pulls, force-updates recursive submodules, and writes the mirror activity cache. --repo selects existing repositories and disables discovery; it does not confine every side effect to those repositories.

Read maintenance.md for prerequisites, exact selection behavior, safety limits, and post-run checks. Help alone requires neither configuration nor installed Git tooling:

bash
.agents/skills/repo-mirror-sources/scripts/sync-netdata-repos.sh --help

No scheduling automation is installed by this skill. A long absence, new repository, or periodic freshness requirement can justify an authorized maintenance task; none makes maintenance a prerequisite to every source read.

Path discipline

.agents/sensitive-data-discipline.md#allowed-alternatives owns path notation. Use ${NETDATA_REPOS_DIR} for mirror paths in skills and evidence; do not embed personal workstation paths in this skill or its helper.

© netdata, GPL-3.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 4 other files (scripts) in .agents/skills/repo-mirror-sources of netdata/netdata.

  • SKILL.md
  • how-tos/INDEX.md
  • maintenance.md
  • scripts/sync-netdata-repos.sh
  • scripts/test_sync.py

Open the folder on GitHubat commit a7f3cf9

Compare with similar skills

Repo Mirror Sources 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.

Repo Mirror Sources compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repo Mirror Sources this skillnetdata/netdata81k—~1.2kAutomated safety check: NotesGPL-3.0
CI Failure Triage and RepairChachamaru127/claude-code-harness3.2k1 repos~1.1kAutomated safety check: NotesMIT
Bfe Rd Workflowbfenetworks/bfe6.3k—~1.3kAutomated safety check: PassApache-2.0
Ssh Skillbadseal/ssh-skill537—~2.4kAutomated safety check: NotesNone
GreptimeDB Release RunbookGreptimeTeam/greptimedb6.7k—~1.4kAutomated safety check: PassApache-2.0
Crabbox Quickstartopenclaw/crabbox1.5k—~1.6kAutomated safety check: NotesMIT

Similar skills

  • CI Failure Triage and Repair

    Chachamaru127/claude-code-harness

    Diagnoses failing CI pipelines and tests, deciding first whether the test or the implementation is at fault, and hands hard cases to a dedicated fixer subagent.

    3.2k GitHub starsUsed in 1 repo~1.1k tokens
    DevOps & CloudAuto-check: notes
  • Bfe Rd Workflow

    bfenetworks/bfe

    引导用户在 bfe 代码库中完成一次完整的功能研发流程,包括需求对齐、文档修改、代码实现、集成测试与回归验证. An agent skill from bfenetworks/bfe.

    6.3k GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Ssh Skill

    badseal/ssh-skill

    A skill your agent uses when a task requires SSH or SCP/SFTP behavior, a remote server, server alias/IP/hostname/user@host, bastion or jump-host access, remote command execution, upload/download…

    537 GitHub stars~2.4k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • GreptimeDB Release Runbook

    GreptimeTeam/greptimedb

    Runbook for publishing a GreptimeDB version: pick the release branch, verify the Cargo version, then tag, create the GitHub release and open the docs note PR.

    6.7k GitHub stars~1.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Crabbox Quickstart

    openclaw/crabbox

    Gets you running your repository's tests in a disposable Docker or Podman container on your own machine with Crabbox, with no account and no cloud spend.

    1.5k GitHub stars~1.6k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Review

    werf/werf

    Code review of a pull request, branch, or diff. An agent skill from werf/werf.

    4.7k GitHub stars~2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from netdata/netdata

All 27 skills in this repo
  • Docs Learn PR Preview

    netdata/netdata

    Use only when the user explicitly asks to build, run, preview, inspect, or validate learn.netdata.cloud locally using the contents of a PR or documentation branch before merge.

    81k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Triage Agent Events

    netdata/netdata

    Investigate Netdata crashes, panics and fatals from agent-events captures or authorized fleet queries.

    81k GitHub stars~2.4k tokensUpdated today
    Auto-check: notes
  • Triage Codacy

    netdata/netdata

    Inspect, analyze, troubleshoot, or review Codacy findings and local analyzer/API helpers.

    81k GitHub stars~2.2k tokensUpdated today
    Auto-check: notes
  • Triage Coverity

    netdata/netdata

    Inspect or review Coverity Scan defects and saved CID bundles; fetch live findings or apply verified triage decisions when requested.

    81k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Triage Sonarqube

    netdata/netdata

    Inspect, review, or apply authorized triage decisions to SonarCloud issues and security hotspots; also review the Sonar helpers.

    81k GitHub stars~2.8k tokensUpdated today
    Auto-check: notes
  • Create, review or validate Netdata Prometheus chart profiles, exporter dashboard design, collection policy and stock semantic proofs.

    81k GitHub stars~4.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Repo Mirror Sources

What does Repo Mirror Sources do?

Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested. Repo Mirror Sources is an agent skill from netdata/netdata. Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested.

When should I use Repo Mirror Sources?

Repo Mirror Sources fits situations like: cross-repo lookup; missing sources; mirror freshness.

How do I install Repo Mirror Sources in Claude Code?

Run `npx skills add netdata/netdata --skill repo-mirror-sources -a claude-code`. Or copy the skill folder (.agents/skills/repo-mirror-sources in netdata/netdata) into .claude/skills/repo-mirror-sources in your project. Claude Code loads it when a task matches its description.

How do I install Repo Mirror Sources in Codex?

Run `npx skills add netdata/netdata --skill repo-mirror-sources -a codex`. Or copy the skill folder (.agents/skills/repo-mirror-sources in netdata/netdata) into .agents/skills/repo-mirror-sources in your project. Codex loads it when a task matches its description.

Can I use Repo Mirror Sources 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 netdata/netdata --skill repo-mirror-sources -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repo-mirror-sources, .gemini/skills/repo-mirror-sources, .github/skills/repo-mirror-sources and .opencode/skills/repo-mirror-sources in your project.

What does Repo Mirror Sources need to run?

Going by SKILL.md and its folder, Repo Mirror Sources needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (git and rg). Our summary lists: Python 3; A Bash shell.

Does Repo Mirror Sources access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Repo Mirror Sources safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Repo Mirror Sources use?

Repo Mirror Sources is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Repo Mirror Sources use?

About 1.2k tokens (SKILL.md is roughly 4.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 Repo Mirror Sources?

Skills that share tags, products or a category with Repo Mirror Sources: CI Failure Triage and Repair (Chachamaru127/claude-code-harness, 3.2k stars), Bfe Rd Workflow (bfenetworks/bfe, 6.3k stars), Ssh Skill (badseal/ssh-skill, 537 stars) and GreptimeDB Release Runbook (GreptimeTeam/greptimedb, 6.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repo Mirror Sources?

netdata (a GitHub organization) maintains it in netdata/netdata, which has 80,853 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 9, 2026.

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