How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/netdata/netdata --skill repo-mirror-sourcesBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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
| Task | Read / do |
|---|---|
| Inspect, compare, or review source | Use the read-only route below; load relevant domain skills for the assigned lens |
| Establish whether local evidence is current enough | Record checkout revision/state and the question's required revision; do not assume local means latest |
| Set up, refresh, or troubleshoot the mirror | Read maintenance.md before any sync; apply the scope already authorized by the task |
| Understand helper behavior | Read scripts/sync-netdata-repos.sh; its checks are not a general preservation guarantee |
| Capture a reusable mirror procedure | Follow 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:
: "${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.
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:
.agents/skills/repo-mirror-sources/scripts/sync-netdata-repos.sh --helpNo 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.

