# Mining

> Mine approved external robotics repositories into evidence-cited Robium observations.

- Skill: `robium-ai/mining` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add robium-ai/mining`
- Raw SKILL.md: https://api.skillmd.com/api/skills/robium-ai/mining/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: robium-ai (https://skillmd.com/u/robium-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/robium-ai/mining

---


# Mining

Mine for transferable decisions, not code volume.

## Choose what is worth reading

- Candidate discovery and a one-line registry entry are read-only triage.
  Survey or deep-read only a repository the user named or approved in
  `learnings/SOURCES.md`.
- Start with a survey of the tree, active code paths, documentation, examples,
  tests, and license. Spend deep-reading effort only where the survey finds a
  decision that could change a Robium skill.
- Prefer official/vendor sources. Use comparative reads when independent
  projects answer the same question; use a re-crawl when a previously mined
  source changed.
- Read [WORKFLOW.md](WORKFLOW.md) for the survey, deep-read, comparative, and
  re-crawl mechanics.

## Keep only reusable evidence

- Keep patterns, orderings, failure discriminators, integration shapes, and
  configuration decisions that transfer beyond the source project.
- Drop project names, incidental ports, arbitrary tuning, style, and other
  local choices unless they explain a reusable boundary.
- Every observation cites a pinned repository commit, path, line range, and a
  verbatim source excerpt that the citation verifier can find.
- Read [EVIDENCE.md](EVIDENCE.md) for source-authority thresholds, conflicts,
  licensing, placement, and new-skill proposals.

## Preserve the learning boundary

- Output observations and source-registry updates, never direct skill edits.
  Absorption belongs to `learning-loop` and remains separately reviewed.
- Compare findings with existing skills and observations. Record disagreement
  with both provenances; do not silently replace Robium field evidence with an
  upstream idiom.
- Point to source code by default. Vendor code only when it is short, genuinely
  useful as a maintained example, and its license and attribution permit it.
- Do not crawl issue trackers or commit history as part of the current mining
  workflow.

## Done

- The registry records the pinned commit, crawl date, status, and resulting
  observation IDs.
- Citation and observation checks pass for every retained finding.
- Each finding names the owning skill or explains why no current skill owns it.
- Temporary clones and survey reports remain outside the committed plugin.