{
 "schema": "aiblocks-page/1",
 "id": "digital-twin-design-planner",
 "type": "skill",
 "name": "Digital twin design planner",
 "summary": "Bring the system and the decision it should support. Get a twin plan with data, checks and action limits.",
 "headline": "Digital twin design planner",
 "subhead": "Describe the real system, data sources and decision. It plans the twin data, checks its accuracy and sets limits on any actions it may guide.",
 "job": {
  "id": "build-software",
  "name": "Build and ship software"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "source_text",
   "required": false,
   "label": "Source text",
   "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link"
  }
 ],
 "outputs": [
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  },
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  }
 ],
 "you_give": [
  "The system or process the twin will copy.",
  "The places its data comes from.",
  "The decision the twin should help with.",
  "How fresh and accurate the data must be.",
  "The owner, the risk level and the actions the twin may take (optional)."
 ],
 "you_get": [
  "A label for your idea: model, shadow or twin.",
  "A plan for identities, data formats, timing and proof of origin.",
  "A test plan that checks the twin against real results.",
  "A checklist of proof needed before the twin may act.",
  "A list of open gaps with owners."
 ],
 "use_when": [
  "Someone says \"build a digital twin\" and you need to know what that should mean.",
  "You have a dashboard or event feed and want to know if it is really a twin.",
  "A twin shows old or clashing data and you must decide whether to pause it.",
  "You want to let a twin act on a real system and need proof it is safe."
 ],
 "skip_when": [
  "You only need a dashboard or a list of what depends on what: build that with your usual monitoring or data tools, since no twin is needed.",
  "You want rules for how your whole company uses AI: ask your AI for an AI governance policy, or a person who owns that work.",
  "You want help running one named tool, such as a cloud or build tool: use that tool's own guide or support."
 ],
 "output_sample": {
  "input": [
   "The real system or process you want to copy",
   "Where its data comes from",
   "The decision the twin should help with",
   "Who owns it and how risky a mistake is",
   "Which actions the twin may take, if any (optional)"
  ],
  "output": [
   {
    "name": "Classification",
    "contains": "Says if your idea is a model, a shadow or a true twin, and what is missing."
   },
   {
    "name": "Twin manifest",
    "contains": "Names the system copied, its data sources, how fresh the data must be, and what actions are allowed."
   },
   {
    "name": "Architecture contracts",
    "contains": "Sets identities, event formats, timestamps, proof of origin, and how uncertainty is shown."
   },
   {
    "name": "Evaluation plan",
    "contains": "Shows how to test the twin against real results, and when it must stop and hold."
   },
   {
    "name": "Release evidence checklist",
    "contains": "Lists the proof needed before the twin may do more than watch, with a decision of approve, hold or block."
   },
   {
    "name": "Open gaps",
    "contains": "Lists unresolved questions, each with an owner or a way to escalate."
   }
  ]
 },
 "how_to_use": [
  "Open Claude, ChatGPT or Gemini. Paste in the skill text, or upload the skill folder if your AI accepts files.",
  "Describe, in this order, the system, its data sources, the decision the twin should help with, the owner, the risk level and the actions it may take. If you do not know one, say so.",
  "Ask for the classification first, then the plan and the release checklist.",
  "Read the open gaps and fill them in before you trust the plan. Then ask the named owner to approve, hold or block the release, and act on that decision: approve means proceed, hold means fill the gaps, block means stop.",
  "No code or paid tool is needed. The plan is a document, not a running twin."
 ],
 "checks": [],
 "next": [
  {
   "name": "MATLAB signal filter designer",
   "url": "https://useaiblocks.com/skills/digital-filter-designer",
   "why": "Build it"
  }
 ],
 "source": {
  "by": "magnus919",
  "repo": "magnus919/agent-skills",
  "url": "https://github.com/magnus919/agent-skills/tree/92c327e525da69c9ad3812fd223a1770e977c2e3/digital-twin",
  "licence": "MIT",
  "original_name": "digital-twin",
  "commit": "92c327e525da69c9ad3812fd223a1770e977c2e3"
 },
 "credits": [
  {
   "title": "digital-twin skill",
   "by": "magnus919",
   "url": "https://github.com/magnus919/agent-skills/tree/92c327e525da69c9ad3812fd223a1770e977c2e3/digital-twin",
   "used": "Original instructions and supporting files, with attribution and the MIT licence. Display copy describes the task."
  }
 ],
 "files": [
  "evals/evals.json",
  "LICENSE.md",
  "README.md",
  "references/architecture.md",
  "references/evaluation.md",
  "references/governance.md",
  "references/implementation.md",
  "references/lifecycle.md",
  "references/source-index.md",
  "templates/evaluation-plan.md",
  "templates/release-evidence.md",
  "templates/twin-manifest.yaml"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/digital-twin-design-planner",
  "markdown": "https://useaiblocks.com/skills/digital-twin-design-planner.md",
  "json": "https://useaiblocks.com/skills/digital-twin-design-planner.json",
  "instructions": "https://useaiblocks.com/skills/digital-twin-design-planner/SKILL.md",
  "download": "https://useaiblocks.com/skills/digital-twin-design-planner.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/digital-twin-design-planner",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/digital-twin-design-planner",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
