CommunityCoding & Developmentgithub.com

Mining Experiment Protocol

Transform mining research questions into test protocols that distinguish factor effects: select controls and experimental designs, arrange factor levels, independent replicates, and measurements, reducing ineffective trials and confounding. Suitable for design, optimization, and protocol review in rock mechanics, similar simulation, and field tests.

What is Mining Experiment Protocol?

This skill, 'Mining Experiment Protocol,' helps AI agents and users design rigorous, resource-efficient mining experiments. It addresses a critical challenge in mining research: ensuring that every test condition, measurement, and replicate contributes to answering a specific research question. The skill guides users through selecting the appropriate experimental design—whether for factor screening, mechanism verification, interaction analysis, or parameter optimization—while considering constraints like limited specimens, equipment, and field conditions. It proactively identifies design flaws such as batch confounding, pseudo-replication, insufficient measurements, and infeasible factor combinations before data collection begins. The workflow begins by clarifying the research comparison, experimental units, and response variables, then proceeds to design selection with optional use of a local script for full factorial layouts. It supports platforms like Claude Code, Cursor, and Codex by providing structured markdown documentation, references for method selection and tool usage, and a flexible protocol outline asset. The skill ensures that output includes justified recommendations, clear trade-offs for comparative designs, and executable test arrangements, while avoiding fictitious results and deferring to approved plans for field operations. Its value lies in reducing wasted experiments and confounding, making it indispensable for rock mechanics, similar simulation, and field test design, optimization, and peer review.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/79109/agent-skills-test/tree/HEAD/skill/mining-experiment-protocol

Installed? Explore more Coding & Development skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

mining-experiment-protocol

Organize the protocol around the question "What exactly can this set of experiments answer?", ensuring every group, every measurement point, and every replicate has a clear purpose.

Core Capabilities

  • Select design based on research objective: Distinguish between factor screening, mechanism verification, interaction analysis, and parameter optimization, and choose the corresponding experimental arrangement.
  • Utilize limited experimental resources: Arrange grouping and execution order based on specimen, equipment, and site conditions; identify replicates that can be reduced and controls that cannot be omitted.
  • Detect design flaws early: Check for batch confounding, pseudo-replication, insufficient measurements, and infeasible factor combinations; correct problems before data collection.

Getting Started

From existing materials, determine the research question, primary response variable, controllable factors, experimental objects, and resource constraints. If an existing protocol is available, prioritize targeted improvements; if only research ideas exist, first propose a suitable design and justification. Only ask for information that would change the design choice; for any remaining gaps, proceed with clear assumptions.

Workflow

  1. Clarify the research comparison, independent experimental units, and primary response variable.
  2. Select the design based on factor count, interactions, batch and resource constraints; invoke a local script when a full factorial layout is needed.
  3. Translate experimental combinations into measurements, execution order, and analysis methods; explain what questions the design can and cannot answer.

Use Resources as Needed

  • Before using local tools, read Parameters and Scope, then call scripts/generate_design.py. The tool only handles the specified format and capabilities; it does not represent completion of the full task.
  • When first learning about the input format, review the synthetic example examples/design.json; demo data must not be treated as actual measurements or specification parameters.
  • For method selection, boundary judgment, or complex scenarios: read references/methods.md.
  • When you need to quickly organize deliverable content, copy and trim assets/protocol-outline.md; this is an optional starting point, not a fixed output format.

Deliverable

Provide the recommended design, key selection rationale, and executable experimental arrangement; when comparing designs, explain trade-offs. Attach factor combinations, measurement layouts, or analysis ideas as appropriate to the task, using the user's existing format—no fixed number of tables or section length.

Experimental parameters and field implementation conditions must be justified. Do not write results for unfinished experiments; for field operations, specific execution must conform to applicable approved plans.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Related Skills