Observability Architecture
majiayu000/litellm-rs
LiteLLM-RS Observability Architecture. An agent skill from majiayu000/litellm-rs.
Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins.
Install Collectors Authoring
$ npx skills add netdata/netdata --skill collectors-authoring -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install netdata/netdata collectors-authoring --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/collectors-authoring .claude/skills/collectors-authoring && 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 "collectors-authoring" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/collectors-authoring into .claude/skills/collectors-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "collectors-authoring", 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/collectors-authoringType 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 collectors-authoring -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install netdata/netdata collectors-authoring --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/collectors-authoring .agents/skills/collectors-authoring && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "collectors-authoring" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/collectors-authoring into .agents/skills/collectors-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "collectors-authoring", 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 collectors-authoring -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install netdata/netdata collectors-authoring --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/collectors-authoring .cursor/skills/collectors-authoring && 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 "collectors-authoring" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/collectors-authoring into .cursor/skills/collectors-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "collectors-authoring", 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/collectors-authoring--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 collectors-authoring -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install netdata/netdata collectors-authoring --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/collectors-authoring .gemini/skills/collectors-authoring && 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 "collectors-authoring" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/collectors-authoring into .gemini/skills/collectors-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "collectors-authoring", 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 collectors-authoringInstalls 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 collectors-authoring -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/collectors-authoring .github/skills/collectors-authoring && 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 "collectors-authoring" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/collectors-authoring into .github/skills/collectors-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "collectors-authoring", 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 collectors-authoring -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 collectors-authoring --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/collectors-authoring .opencode/skills/collectors-authoring && 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 "collectors-authoring" agent skill from https://github.com/netdata/netdata/tree/master/.agents/skills/collectors-authoring into .opencode/skills/collectors-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "collectors-authoring", 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
collectors-authoring- GitHub stars
- 81k
- Token cost
- ~1.9k tokens
- SKILL.md length
- 605 words
- Files
- 4
- Skills in repo
- 27
- Repo updated
- First seen
- Licence
- GPL-3.0
At a glance
Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins.
- Tasks that involve Monitoring and alerting
- SKILL.md covers Shared Collector Contracts, Route By Task, Expand Only The Relevant Detail and Maintaining This Skill
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Collectors Authoring is an agent skill from netdata/netdata. Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins. Start here for collector lifecycle, metric identity, missing data, cost, cardinality, SNMP/Prometheus profiles, statsd, logs, topology, flow/OTEL ingestion and Functions. Routes to domain and framework guidance. Operator queries use the query skills.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `collector-practices.md`, `dashboard-shaping.md` and `landscape-and-domains.md`).
It sits in DevOps & Cloud, covering Monitoring and alerting. It works with OpenTelemetry, Prometheus and Rust. 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 Monitoring and alerting
Example prompts
- “/collectors-authoring”
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
Collectors Authoring loads about 1.9k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 605 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). 605 words, ~1,941 tokens.
Download SKILL.mdSave it as
.claude/skills/collectors-authoring/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- collectors-authoring
- description
- Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins. Start here for collector lifecycle, metric identity, missing data, cost, cardinality, SNMP/Prometheus profiles, statsd, logs, topology, flow/OTEL ingestion and Functions. Routes to domain and framework guidance. Operator queries use the query skills.
Collector Authoring And Review
Start here for collector changes and reviews, then follow the affected domain or framework. Selection and action
boundaries are owned by AGENTS.md#skill-selection: reading a recipe does not authorize its generation, installation,
credential setup or live operations. A review uses existing design/validation evidence and reports concrete gaps.
Shared Collector Contracts
Every collector review needs the applicable shared contracts below, including a performance-focused review. These summaries point to the detailed owner sections; expand further according to changed behavior and dependencies.
| Contract | Details |
|---|---|
| Stable public chart/dimension identities and truthful measurement gaps | ./collector-practices.md#13-ids-are-public-contracts, ./collector-practices.md#14-gaps-are-data |
| Known removal versus temporary unreachability; source-appropriate chart lifecycle | ./collector-practices.md#15-obsolete-whats-gone |
| Bounded work, resource lifetime, failure behavior and useful cardinality | ./collector-practices.md#22-hot-path-discipline, ./collector-practices.md#25-cardinality-bounding, ./collector-practices.md#4-production-quality-criteria--pre-pr-checklist |
| Contextual errors and bounded logging using the framework mechanism | ./collector-practices.md#23-error-handling, ./collector-practices.md#24-logging-discipline |
| Supported-source semantics and representative validation evidence | ./collector-practices.md#16-verify-the-supported-source-contract, ./collector-practices.md#21-test-against-reality |
| Correct framework/version, configuration and generated-source ownership | ./collector-practices.md#52-god-v1--v2-reality-check, ./collector-practices.md#26-configuration-discipline, ./collector-practices.md#27-generated-artifacts-are-not-source |
For a contract-preserving parser optimization, these shared constraints and the parser/framework evidence may suffice. For ownership, caching or lifecycle costs, also expand the design references. A lens does not exempt applicable contracts or require every reference in this skill.
Route By Task
Use each row for implementation or review of that surface. Implementation-only notes and commands are not review
prerequisites. In Go work, read src/go/AGENTS.md and the relevant subtree instructions first.
| Task | Start with |
|---|---|
| New go.d collector | .agents/skills/collectors-go-design/SKILL.md, then src/go/plugin/go.d/docs/how-to-write-a-collector.md, .agents/skills/collectors-go-framework-v2/SKILL.md, and .agents/skills/integrations-lifecycle/recipes/add-go-collector.md; implementation records the design before code |
| go.d config option, mode, metric meaning, Functions, ownership or vnode change | .agents/skills/collectors-go-design/SKILL.md for affected items; framework/version guidance and .agents/skills/integrations-lifecycle/consistency.md for coupled artifacts |
| Existing go.d collector fix | Collector-local files, relevant framework/version contract, .agents/skills/integrations-lifecycle/consistency.md and its recipes/update-collector.md workflow for authorized delivery |
| V1-to-V2 migration | src/go/plugin/go.d/docs/migrate-v1-to-v2.md and .agents/skills/collectors-go-framework-v2/SKILL.md; preserve compatibility rather than inventing enrichment |
| Shared framework/helper change | src/go/plugin/framework/docs/changing-framework-code.md; the applicable gate precedes implementation |
| Collector metadata content | .agents/skills/collectors-metadata-yaml/SKILL.md, affected fields only; pipeline mechanics in .agents/skills/integrations-lifecycle/SKILL.md |
| IBM workload collector | src/go/plugin/ibm.d/AGENTS.md and src/go/plugin/ibm.d/framework/README.md; IBM has its own framework and generated-source contract |
| Rust plugin | src/crates/netdata-plugin/ SDK and src/crates/netflow-plugin/ reference; platform/build context in ./landscape-and-domains.md#ibmd-rust-sdk-internal-c-pluginsd |
| Internal C plugin | src/collectors/README.md, adjacent collector and ./landscape-and-domains.md#ibmd-rust-sdk-internal-c-pluginsd |
| External plugin in another language | src/plugins.d/README.md for PLUGINSD |
| SNMP profile or trap profile | .agents/skills/collectors-snmp-profiles/SKILL.md or .agents/skills/collectors-snmp-trap-profiles/SKILL.md; metric profiles use src/go/plugin/go.d/collector/snmp/profile-format.md |
| Prometheus chart profile | .agents/skills/collectors-prometheus-profiles/SKILL.md; source and real-pipeline validation for the affected profile, with review action boundaries retained |
| Interactive Function | src/go/plugin/framework/functions/README.md, src/plugins.d/FUNCTION_UI_SCHEMA.json, src/plugins.d/FUNCTION_UI_DEVELOPER_GUIDE.md |
| Topology producer | .agents/skills/topology-authoring/SKILL.md, src/go/pkg/topology/v1, src/plugins.d/FUNCTION_TOPOLOGY_SCHEMA.json |
| Auto-discovery rule edit | Rules under src/go/plugin/go.d/config/go.d/sd/; engine src/go/plugin/agent/discovery/ |
| New go.d discoverer or changed discovery capability, ownership or lifecycle | .agents/skills/collectors-go-design/SKILL.md#the-collector-design-note and its architecture gate; implementation under src/go/plugin/go.d/discovery/sdext/discoverer/; shared engine under src/go/plugin/agent/discovery/ |
| OTEL ingestion or mapping | src/crates/otel-plugin/, src/crates/otel-ingestor/ and ./dashboard-shaping.md |
| Log ingestion or exploration | src/collectors/log2journal/, its log2journal.d/ rules and ./landscape-and-domains.md#logs |
| Cross-plugin enrichment | ./collector-practices.md#29-cross-plugin-enrichment-via-netipc |
| Credentials or privileged operations | src/collectors/SECRETS.md and src/collectors/utils/ndsudo.c |
Show full SKILL.md (165 more words)Show less
Expand Only The Relevant Detail
- Metrics, labels, chart shape, grouping and priorities:
./collector-practices.md#3-structuring-dashboards. SNMP, statsd, OTEL and Prometheus shaping mechanisms:./dashboard-shaping.md. - Remote targets and generated nodes:
./collector-practices.md#19-remote-monitored-systems-and-vnodesand the framework/design owners it cites. Multiple targets alone do not justify a vnode per target. - Language/platform choice, build loop, eBPF migration, data types and domain patterns:
./landscape-and-domains.md. Open the relevant section; preserve its CO-RE versus legacy validation distinction. - Implementation quality and delivery checks:
./collector-practices.md#4-production-quality-criteria--pre-pr-checklist. Reviewers use applicable criteria and existing evidence; authors complete the authorized validation. - Other source owners:
./collector-practices.md#6-canonical-documentation-pointers.
Maintaining This Skill
Capture reusable, evidence-backed gaps under AGENTS.md#knowledge-capture. During authorized implementation, update
this skill and coupled pointers in the same task; answer-only findings follow the owner's local-note route. Keep
framework-specific mechanisms with their owners and preserve the domain detail when improving the entry.
When a pointer misled the task, capture the reusable failure mode with its correction. Describe coupled skill updates
in the PR when one is created; do not preserve obsolete instructions as current guidance.
© 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 3 other files in .agents/skills/collectors-authoring of netdata/netdata.
- SKILL.md
- collector-practices.md
- dashboard-shaping.md
- landscape-and-domains.md
Open the folder on GitHubat commit 2c378f0
Compare with similar skills
Collectors Authoring 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 |
|---|---|---|---|---|---|---|
| Collectors Authoring this skillnetdata/netdata | 81k | — | ~1.9k | Automated safety check: Pass | GPL-3.0 | |
| Observability Architecturemajiayu000/litellm-rs | 117 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Syncmetapawurb/hotpath-rs | 1.9k | — | ~1.2k | Automated safety check: Notes | MIT | |
| Signozqjoly/GitOps | 112 | — | ~6.1k | Automated safety check: Pass | WTFPL | |
| Logfire Instrumentationbasicmachines-co/basic-memory | 4.1k | — | ~2.3k | Automated safety check: Pass | AGPL-3.0 | |
| Qdrant Advisorqdrant/skills | 253 | — | ~1.7k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Syncmeta
pawurb/hotpath-rs
Sync changes from the hotpath, hotpath-macros and hotpath-drain crates to their meta counterparts (hotpath-meta, hotpath-macros-meta and hotpath-drain-meta).
Signoz
qjoly/GitOps
Manage the self-hosted SigNoz observability stack in this GitOps repo.
Logfire Instrumentation
basicmachines-co/basic-memory
Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.
- Official
Qdrant Advisor
qdrant/skills
Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech.
Developing Funboost Mixin
ydf0509/funboost
当需要为 funboost 创建 Consumer 或 Publisher 的 Mixin 扩展类时使用。触发场景：添加监控、熔断、限流、链路追踪等横切关注点，编写自定义前置/后置处理钩子。关键词：mixin, consumeroverridecls, publisheroverridecls, ConsumerMixin, 自定义消费者, hook, 拦截器, 熔断器, 监控…
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 Collectors Authoring
What does Collectors Authoring do?
Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins. Collectors Authoring is an agent skill from netdata/netdata. Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins.
When should I use Collectors Authoring?
Collectors Authoring fits situations like: tasks that involve Monitoring and alerting.
How do I install Collectors Authoring in Claude Code?
Run `npx skills add netdata/netdata --skill collectors-authoring -a claude-code`. Or copy the skill folder (.agents/skills/collectors-authoring in netdata/netdata) into .claude/skills/collectors-authoring in your project. Claude Code loads it when a task matches its description.
How do I install Collectors Authoring in Codex?
Run `npx skills add netdata/netdata --skill collectors-authoring -a codex`. Or copy the skill folder (.agents/skills/collectors-authoring in netdata/netdata) into .agents/skills/collectors-authoring in your project. Codex loads it when a task matches its description.
Can I use Collectors Authoring 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 collectors-authoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/collectors-authoring, .gemini/skills/collectors-authoring, .github/skills/collectors-authoring and .opencode/skills/collectors-authoring in your project.
What does Collectors Authoring need to run?
SKILL.md names no scripts, command-line tools or credentials: Collectors Authoring is instructions for the agent only.
Does Collectors Authoring 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 Collectors Authoring 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 Collectors Authoring use?
Collectors Authoring 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 Collectors Authoring use?
About 1.9k tokens (SKILL.md is roughly 7.8k 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 Collectors Authoring?
Skills that share tags, products or a category with Collectors Authoring: Observability Architecture (majiayu000/litellm-rs, 117 stars), Syncmeta (pawurb/hotpath-rs, 1.9k stars), Signoz (qjoly/GitOps, 112 stars) and Logfire Instrumentation (basicmachines-co/basic-memory, 4.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Collectors Authoring?
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.