# Dpgen Run

> Prepare, explain, validate, and run DP-GEN concurrent-learning workflows using param.json and machine.json.

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

---


# DP-GEN Run

Use this skill for the iterative train, explore, label, and retrain workflow.

## Contract

- Keep scientific settings in `param.json` and execution settings in `machine.json`.
- Run exactly `dpgen run param.json machine.json`.
- Prepare and validate by default; execute only after explicit confirmation.

## Workflow

1. Inspect existing data and configurations before asking for inputs.
1. Patch working files and preserve scientific/site-specific choices.
1. Load only the references needed for the task.
1. Validate schemas, generated task inputs, stage state, and monitoring signals.
1. Report paths, command, per-system evidence, risks, and next checks.

## References

- [Workflow guidance](references/workflow.md): scope, layout, policy, and reporting.
- [Configuration, validation, and execution](references/validation-and-run.md): both JSON files, generated-input checks, and safe launch/restart checks.
- [Monitoring and troubleshooting](references/monitoring.md): accuracy trends, stage progress, and evidence-based diagnosis.

## Guardrails

- Never merge the JSON files or invent paths, queues, modules, or commands.
- Preserve descriptor, backend, thresholds, schedules, ensemble, and `type_map` choices.
- Check `se_atten_v2` against the installed backend; `fp_style: "none"` is invalid.
- Stop and ask when required scientific or execution inputs are undiscoverable.