CI Runner Audit
apache/magpie
Read-only audit of GitHub Actions runner compatibility for one repository, a repository set, one Apache project, or the full Apache org.
Change, review or troubleshoot Learn publication, docs/.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior.
Install Docs Learn Site Structure
$ npx skills add netdata/netdata --skill docs-learn-site-structure -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install netdata/netdata docs-learn-site-structure --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/netdata/netdata.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-learn-site-structure .claude/skills/docs-learn-site-structure && rm -rf skills-srcUse ~/.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/
Install the "docs-learn-site-structure" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/docs-learn-site-structure into .claude/skills/docs-learn-site-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-learn-site-structure", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/netdata/netdata/tree/master/.agents/skills/docs-learn-site-structureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add netdata/netdata --skill docs-learn-site-structure -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install netdata/netdata docs-learn-site-structure --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/netdata/netdata.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/docs-learn-site-structure .agents/skills/docs-learn-site-structure && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "docs-learn-site-structure" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/docs-learn-site-structure into .agents/skills/docs-learn-site-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-learn-site-structure", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add netdata/netdata --skill docs-learn-site-structure -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install netdata/netdata docs-learn-site-structure --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/netdata/netdata.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/docs-learn-site-structure .cursor/skills/docs-learn-site-structure && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "docs-learn-site-structure" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/docs-learn-site-structure into .cursor/skills/docs-learn-site-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-learn-site-structure", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/netdata/netdata.git --path .agents/skills/docs-learn-site-structure--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add netdata/netdata --skill docs-learn-site-structure -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install netdata/netdata docs-learn-site-structure --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/netdata/netdata.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/docs-learn-site-structure .gemini/skills/docs-learn-site-structure && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "docs-learn-site-structure" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/docs-learn-site-structure into .gemini/skills/docs-learn-site-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-learn-site-structure", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install netdata/netdata docs-learn-site-structureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add netdata/netdata --skill docs-learn-site-structure -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/netdata/netdata.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/docs-learn-site-structure .github/skills/docs-learn-site-structure && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "docs-learn-site-structure" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/docs-learn-site-structure into .github/skills/docs-learn-site-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-learn-site-structure", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add netdata/netdata --skill docs-learn-site-structure -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install netdata/netdata docs-learn-site-structure --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/netdata/netdata.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/docs-learn-site-structure .opencode/skills/docs-learn-site-structure && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "docs-learn-site-structure" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/docs-learn-site-structure into .opencode/skills/docs-learn-site-structure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "docs-learn-site-structure", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
docs-learn-site-structure- GitHub stars
- 81k
- Token cost
- ~1.7k tokens
- SKILL.md length
- 737 words
- Files
- 13
- Skills in repo
- 27
- Repo updated
- First seen
- Licence
- GPL-3.0
At a glance
Change, review or troubleshoot Learn publication, docs/.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior.
- Tasks that involve Markdown
- SKILL.md covers Owners, Tasks and Rules
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Docs Learn Site Structure is an agent skill from netdata/netdata. Change, review or troubleshoot Learn publication, docs/.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior. Local site builds require docs-learn-pr-preview; generated integration content uses metadata/integrations skills.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files (for example `authoring-boundary.md`, `how-tos/integration-card-description-links.md` and `how-tos/repairing-empty-mapped-pages.md`).
It sits in DevOps & Cloud, covering Markdown. It works with GitHub Actions. 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
- Tasks that involve Markdown
Example prompts
- “/docs-learn-site-structure”
What it can do on your machine
Read from SKILL.md and the folder at commit 2c378f0. 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
Docs Learn Site Structure loads about 1.7k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 737 words of instructions outside code blocks.
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 netdata/netdata at commit 2c378f0, republished under its GPL-3.0 licence (© netdata). 737 words, ~1,669 tokens.
Download SKILL.mdSave it as
.claude/skills/docs-learn-site-structure/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.- name
- docs-learn-site-structure
- description
- Change, review or troubleshoot Learn publication, docs/.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior. Local site builds require docs-learn-pr-preview; generated integration content uses metadata/integrations skills.
Learn site structure
A page on learn.netdata.cloud is a node in this repository's docs/.map/map.yaml, rendered by the ingest of the
netdata/learn repository into a Docusaurus site that Netlify deploys. This skill states what an author or reviewer
here relies on; the how-to-publish procedure is docs/.map/README.md, and the mechanics live in the learn repository.
Apply AGENTS.md#skill-selection. Review the affected publication contract and existing evidence; recipe instructions
do not require a new SOW or authorize deletion, publication, ingest or a local preview. Use the task and symptom routes
below, including their dependencies when a change reaches another surface.
Learn-side facts carry the revision at which they were checked. Before relying on a claim affected by the task, inspect
that contract at the relevant available Learn revision and report any evidence gap. repo-mirror-sources supplies the
read-only checkout/revision workflow; loading this skill does not request a mirror refresh.
Owners
| Owner | What it decides |
|---|---|
docs/.map/README.md#steps-to-publish | the publish and unpublish procedure, meta fields, path reconstruction, the placeholder node, the local test command |
docs/.map/map.schema.json | node shapes, required fields, the edit_url pattern, the integration_kind members |
docs/.map/validate_map_schema.py | the three custom map rules (no duplicate edit_url; a leaf needs an edit_url; a netdata/netdata edit_url names an existing file) |
.github/workflows/trigger-learn-update.yml | which pushes to master here dispatch the learn ingest |
.github/workflows/check-markdown.yml | the PR gate here that regenerates integrations, runs the map validator, and runs the real ingest with --fail-links-netdata |
netdata/learn: ingest/ingest.py, ingest/autogenerateRedirects.py, static.toml, .github/workflows/ingest.yml, README.md, AGENTS.md | everything the site does with a mapped file; facts in this skill are verified against netdata/learn @ c3a16edd5ee4dc819976ef162c9afaff4b9b968c and cite the symbol, never a line |
.agents/sensitive-data-discipline.md#allowed-alternatives | how paths into the learn repository are written in committed text (${NETDATA_REPOS_DIR}/learn/...; .agents/ENV.md documents the key) |
Sibling skills: integrations-lifecycle produces the integration pages that ingest splices in through placeholders;
collectors-metadata-yaml owns the author-side MDX safety rules for metadata.yaml text; docs-learn-pr-preview
builds the site locally from a PR and loads this skill first; repo-mirror-sources maintains the checkout under
${NETDATA_REPOS_DIR} that the learn paths refer to.
Tasks
| Task | Read |
|---|---|
| review a page, mapping or pipeline change | the affected task/symptom references below and current owner evidence; no recipe execution solely for review |
| add a page | ./recipes/add-doc-page.md, then ./mapping.md |
| move a page to another section | ./recipes/move-doc-page.md, ./redirects.md |
| rename a page (label or URL) | ./recipes/rename-doc-page.md, ./mapping.md#file-path-and-slug |
| delete or unpublish a page | ./recipes/delete-doc-page.md, docs/.map/README.md#unpublishing-files |
| decide where an edit belongs | ./authoring-boundary.md |
| understand or debug what ran in CI | ./pipeline.md |
| a mapped page renders empty | ./how-tos/repairing-empty-mapped-pages.md |
| links from integration descriptions to Learn | ./how-tos/integration-card-description-links.md |
Symptom to file: page missing on Learn or URL not what was expected: ./mapping.md#the-join-key; ingest exited 2
or the map validator failed: ./mapping.md#what-is-checked-and-by-what; exited 3: ./redirects.md; traceback naming
resolve_publish_path_collisions or populate_integrations: ./mapping.md; MDX build error or a page cut off:
./mdx-rules.md; sidebar order, missing category, or a grid that turned into a page: ./sidebars.md; old URL 404
or redirect loop: ./redirects.md; a change vanished from docs/ in the learn repository: ./authoring-boundary.md.
Show full SKILL.md (262 more words)Show less
Rules
Enforced by code (the file names the tool and the effect):
map.yamlmust validate againstdocs/.map/map.schema.json; ingest exits 2 otherwise (./mapping.md#what-is-checked-and-by-what).- A duplicate
edit_url, a leaf without one, or anetdata/netdataedit_urlthat names no file failsdocs/.map/validate_map_schema.py, which.github/workflows/check-markdown.ymlruns after generating the integration pages; run it before opening a map PR (./mapping.md#what-is-checked-and-by-what). - A published path or slug collision that involves a non-integration page aborts ingest (
ValueError); integration duplicates are suffixed automatically (./mapping.md#file-path-and-slug). - A redirect catalogue entry that resolves to nothing and is neither covered nor retired aborts ingest with exit 3
(
./redirects.md). - A broken link or anchor in a mapped page fails
.github/workflows/check-markdown.ymlon the PR here, and the learn ingest under--fail-links(./pipeline.md#verification-before-merging-here). - Every
.mdand.mdxunder learndocs/withoutpart_of_learn: True, and every.jsonunconditionally, is deleted at the start of each full ingest (./authoring-boundary.md).
Hand-reviewed, because no code checks them:
- Every published page has a
map.yamlnode withlabelandedit_url; a file without a node is silently skipped, and a node of another repository whose URL matches no file is silently unpublished (./mapping.md#the-join-key). - Keep
edit_urlunchanged when moving a page; the redirect catalogue is anchored to it (./redirects.md). - A label decides the URL; choose labels that survive
_sanitize_mdx_filename_sourcewithout colliding with a sibling (./mapping.md#file-path-and-slug). - Cross-references are repository-relative
.mdpaths, neverlearn.netdata.cloudURLs (./mapping.md#links-between-pages). - Text that MDX reads as a tag (
<word>,<before a digit, generics) is wrapped in inline code or rephrased (./mdx-rules.md). - Learn paths in committed text use the
${NETDATA_REPOS_DIR}/learn/...form; facts about learn code carry theowner/repo @ committhey were verified against.
© 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 12 other files in .agents/skills/docs-learn-site-structure of netdata/netdata.
- SKILL.md
- authoring-boundary.md
- how-tos/integration-card-description-links.md
- how-tos/repairing-empty-mapped-pages.md
- mapping.md
- mdx-rules.md
- pipeline.md
- recipes/add-doc-page.md
- recipes/delete-doc-page.md
- recipes/move-doc-page.md
- recipes/rename-doc-page.md
- redirects.md
- sidebars.md
Open the folder on GitHubat commit 2c378f0
Compare with similar skills
Docs Learn Site Structure 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Docs Learn Site Structure this skillnetdata/netdata | 81k | — | ~1.7k | Automated safety check: Pass | GPL-3.0 | |
| CI Runner Auditapache/magpie | 112 | — | ~2.4k | Automated safety check: Pass | Apache-2.0 | |
| Run Uatoocx/tfplan2md | 174 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Save Researchmeain/dotfiles | 285 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Generate Demo Artifactsoocx/tfplan2md | 174 | — | ~798 | Automated safety check: Pass | MIT | |
| Update Test Snapshotsoocx/tfplan2md | 174 | — | ~734 | Automated safety check: Pass | MIT |
Similar skills
Run Uat
oocx/tfplan2md
Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps.
Save Research
meain/dotfiles
Summarize and save research findings from the current conversation into a well-structured markdown document.
Generate Demo Artifacts
oocx/tfplan2md
Generate the comprehensive demo markdown artifacts from the current codebase.
Update Test Snapshots
oocx/tfplan2md
Regenerate test snapshot files after intentional markdown output changes.
- Official
Analyze GitHub Action Logs
withastro/astro
Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.
More from netdata/netdata
All 27 skills in this repoDocs 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.
Repo Mirror Sources
netdata/netdata
Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested.
Triage Agent Events
netdata/netdata
Investigate Netdata crashes, panics and fatals from agent-events captures or authorized fleet queries.
Triage Codacy
netdata/netdata
Inspect, analyze, troubleshoot, or review Codacy findings and local analyzer/API helpers.
Triage Coverity
netdata/netdata
Inspect or review Coverity Scan defects and saved CID bundles; fetch live findings or apply verified triage decisions when requested.
Triage Sonarqube
netdata/netdata
Inspect, review, or apply authorized triage decisions to SonarCloud issues and security hotspots; also review the Sonar helpers.
Related
Works with
Categories
Questions about Docs Learn Site Structure
What does Docs Learn Site Structure do?
Change, review or troubleshoot Learn publication, docs/.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior. Docs Learn Site Structure is an agent skill from netdata/netdata.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior.
When should I use Docs Learn Site Structure?
Docs Learn Site Structure fits situations like: tasks that involve Markdown.
How do I install Docs Learn Site Structure in Claude Code?
Run `npx skills add netdata/netdata --skill docs-learn-site-structure -a claude-code`. Or copy the skill folder (.agents/skills/docs-learn-site-structure in netdata/netdata) into .claude/skills/docs-learn-site-structure in your project. Claude Code loads it when a task matches its description.
How do I install Docs Learn Site Structure in Codex?
Run `npx skills add netdata/netdata --skill docs-learn-site-structure -a codex`. Or copy the skill folder (.agents/skills/docs-learn-site-structure in netdata/netdata) into .agents/skills/docs-learn-site-structure in your project. Codex loads it when a task matches its description.
Can I use Docs Learn Site Structure 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 docs-learn-site-structure -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-learn-site-structure, .gemini/skills/docs-learn-site-structure, .github/skills/docs-learn-site-structure and .opencode/skills/docs-learn-site-structure in your project.
What does Docs Learn Site Structure need to run?
SKILL.md names no scripts, command-line tools or credentials: Docs Learn Site Structure is instructions for the agent only.
Does Docs Learn Site Structure 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 Docs Learn Site Structure 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 Docs Learn Site Structure use?
Docs Learn Site Structure 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 Docs Learn Site Structure use?
About 1.7k tokens (SKILL.md is roughly 6.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 Docs Learn Site Structure?
Skills that share tags, products or a category with Docs Learn Site Structure: CI Runner Audit (apache/magpie, 112 stars), Run Uat (oocx/tfplan2md, 174 stars), Save Research (meain/dotfiles, 285 stars) and Generate Demo Artifacts (oocx/tfplan2md, 174 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Docs Learn Site Structure?
netdata (a GitHub organization) maintains it in netdata/netdata, which has 80,838 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 8, 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.