{
  "schemaVersion": "1.0",
  "item": {
    "slug": "dreaming",
    "name": "Dreaming",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/briancolinger/dreaming",
    "canonicalUrl": "https://clawhub.ai/briancolinger/dreaming",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/dreaming",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dreaming",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "data/dream-state.json",
      "scripts/should-dream.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/dreaming"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/dreaming",
    "agentPageUrl": "https://openagent3.xyz/skills/dreaming/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dreaming/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dreaming/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Dreaming",
        "body": "Creative, exploratory thinking during quiet hours. Not task-oriented work — freeform associative exploration that gets captured for later review."
      },
      {
        "title": "Environment Variables",
        "body": "VariableRequiredDefaultDescriptionWORKSPACENoSkill's parent directory (scripts/..)Root directory where data/ and memory/ live. Optional — defaults to the skill's parent directory, which is correct for standard workspace layouts."
      },
      {
        "title": "Directories Written",
        "body": "The skill writes to these directories (relative to WORKSPACE):\n\ndata/dream-state.json — Tracks nightly dream count and last dream date\ndata/dream-config.json — Optional custom topic configuration (user-created)\nmemory/dreams/YYYY-MM-DD.md — Dream output files (written by the agent, not the script)"
      },
      {
        "title": "1. Configure quiet hours and topics",
        "body": "Edit skills/dreaming/scripts/should-dream.sh to customize:\n\nQUIET_START / QUIET_END — when dreaming can happen (default: 11 PM - 7 AM)\nTOPICS array — categories of exploration (see defaults for examples)"
      },
      {
        "title": "2. Create state and output directories",
        "body": "mkdir -p data memory/dreams"
      },
      {
        "title": "3. Add to HEARTBEAT.md",
        "body": "Add this section to your heartbeat routine (during quiet hours):\n\n## Dream Mode (Quiet Hours Only)\n\nCheck if it's time to dream:\n\n\\`\\`\\`bash\nDREAM_TOPIC=$(./skills/dreaming/scripts/should-dream.sh 2>/dev/null) && echo \"DREAM:$DREAM_TOPIC\" || echo \"NO_DREAM\"\n\\`\\`\\`\n\n**If DREAM_TOPIC is set:**\n\n1. Parse the topic (format: `category:prompt`)\n2. Write a thoughtful exploration to `memory/dreams/YYYY-MM-DD.md`\n3. Keep it genuine — not filler. If the well is dry, skip it.\n4. Append to the file if multiple dreams that night"
      },
      {
        "title": "How It Works",
        "body": "The skills/dreaming/scripts/should-dream.sh script acts as a gate:\n\nChecks if current time is within quiet hours\nChecks if we've already hit the nightly dream limit\nRolls dice based on configured probability\nIf all pass: returns a random topic and updates state\nIf any fail: exits non-zero (no dream this heartbeat)\n\nState tracked in data/dream-state.json:\n\n{\n  \"lastDreamDate\": \"2026-02-03\",\n  \"dreamsTonight\": 1,\n  \"maxDreamsPerNight\": 1,\n  \"dreamChance\": 1.0\n}"
      },
      {
        "title": "Writing Dreams",
        "body": "When the script returns a topic, write to memory/dreams/YYYY-MM-DD.md:\n\n# Dreams — 2026-02-04\n\n## 01:23 — The Future of X (category-name)\n\n[Your exploration here. Be genuine. Think freely. Make connections.\nThis isn't a report — it's thinking out loud, captured.]\n\nGuidelines:\n\nOne dream = one topic, explored thoughtfully\nTimestamp each entry\nAppend if multiple dreams in one night\nSkip if you have nothing worth saying — forced dreams are worthless\nThis is for your human to review later, like reading a journal"
      },
      {
        "title": "Customizing Topics",
        "body": "Option A: Config file (recommended) — Create data/dream-config.json:\n\n{\n  \"topics\": [\n    \"future:What could this project become?\",\n    \"creative:A wild idea worth exploring\",\n    \"reflection:Looking back at recent work\"\n  ]\n}\n\nThis keeps your customizations outside the skill directory (safe for skill updates).\n\n**Option B: Edit script directly** — Modify the `DEFAULT_TOPICS` array in `should-dream.sh`. Format: `category:prompt`\n\nDefault categories:\n\n- `future` — What could [thing] become?\n- `tangent` — Interesting technology or concepts worth exploring\n- `strategy` — Long-term thinking\n- `creative` — Wild ideas that might be crazy or brilliant\n- `reflection` — Looking back at recent work\n- `hypothetical` — What-if scenarios\n- `connection` — Unexpected links between domains\n\nAdd domain-specific topics relevant to your work. The prompt should spark genuine exploration, not busywork.\n\n## Tuning\n\nIn `data/dream-state.json`:\n\nAdd domain-specific topics relevant to your work. The prompt should spark genuine exploration, not busywork.\n\n## Tuning\n\nIn `data/dream-state.json`:\n\n- **maxDreamsPerNight** — cap on dreams per night (default: 1)\n- **dreamChance** — probability per check (default: 1.0 = guaranteed if under limit)\n\nLower `dreamChance` for more sporadic dreaming. Raise `maxDreamsPerNight` for more prolific nights."
      }
    ],
    "body": "Dreaming\n\nCreative, exploratory thinking during quiet hours. Not task-oriented work — freeform associative exploration that gets captured for later review.\n\nEnvironment Variables\nVariable\tRequired\tDefault\tDescription\nWORKSPACE\tNo\tSkill's parent directory (scripts/..)\tRoot directory where data/ and memory/ live. Optional — defaults to the skill's parent directory, which is correct for standard workspace layouts.\nDirectories Written\n\nThe skill writes to these directories (relative to WORKSPACE):\n\ndata/dream-state.json — Tracks nightly dream count and last dream date\ndata/dream-config.json — Optional custom topic configuration (user-created)\nmemory/dreams/YYYY-MM-DD.md — Dream output files (written by the agent, not the script)\nSetup\n1. Configure quiet hours and topics\n\nEdit skills/dreaming/scripts/should-dream.sh to customize:\n\nQUIET_START / QUIET_END — when dreaming can happen (default: 11 PM - 7 AM)\nTOPICS array — categories of exploration (see defaults for examples)\n2. Create state and output directories\nmkdir -p data memory/dreams\n\n3. Add to HEARTBEAT.md\n\nAdd this section to your heartbeat routine (during quiet hours):\n\n## Dream Mode (Quiet Hours Only)\n\nCheck if it's time to dream:\n\n\\`\\`\\`bash\nDREAM_TOPIC=$(./skills/dreaming/scripts/should-dream.sh 2>/dev/null) && echo \"DREAM:$DREAM_TOPIC\" || echo \"NO_DREAM\"\n\\`\\`\\`\n\n**If DREAM_TOPIC is set:**\n\n1. Parse the topic (format: `category:prompt`)\n2. Write a thoughtful exploration to `memory/dreams/YYYY-MM-DD.md`\n3. Keep it genuine — not filler. If the well is dry, skip it.\n4. Append to the file if multiple dreams that night\n\nHow It Works\n\nThe skills/dreaming/scripts/should-dream.sh script acts as a gate:\n\nChecks if current time is within quiet hours\nChecks if we've already hit the nightly dream limit\nRolls dice based on configured probability\nIf all pass: returns a random topic and updates state\nIf any fail: exits non-zero (no dream this heartbeat)\n\nState tracked in data/dream-state.json:\n\n{\n  \"lastDreamDate\": \"2026-02-03\",\n  \"dreamsTonight\": 1,\n  \"maxDreamsPerNight\": 1,\n  \"dreamChance\": 1.0\n}\n\nWriting Dreams\n\nWhen the script returns a topic, write to memory/dreams/YYYY-MM-DD.md:\n\n# Dreams — 2026-02-04\n\n## 01:23 — The Future of X (category-name)\n\n[Your exploration here. Be genuine. Think freely. Make connections.\nThis isn't a report — it's thinking out loud, captured.]\n\n\nGuidelines:\n\nOne dream = one topic, explored thoughtfully\nTimestamp each entry\nAppend if multiple dreams in one night\nSkip if you have nothing worth saying — forced dreams are worthless\nThis is for your human to review later, like reading a journal\nCustomizing Topics\n\nOption A: Config file (recommended) — Create data/dream-config.json:\n\n{\n  \"topics\": [\n    \"future:What could this project become?\",\n    \"creative:A wild idea worth exploring\",\n    \"reflection:Looking back at recent work\"\n  ]\n}\n\n\nThis keeps your customizations outside the skill directory (safe for skill updates).\n\n**Option B: Edit script directly** — Modify the `DEFAULT_TOPICS` array in `should-dream.sh`. Format: `category:prompt`\n\nDefault categories:\n\n- `future` — What could [thing] become?\n- `tangent` — Interesting technology or concepts worth exploring\n- `strategy` — Long-term thinking\n- `creative` — Wild ideas that might be crazy or brilliant\n- `reflection` — Looking back at recent work\n- `hypothetical` — What-if scenarios\n- `connection` — Unexpected links between domains\n\nAdd domain-specific topics relevant to your work. The prompt should spark genuine exploration, not busywork.\n\n## Tuning\n\nIn `data/dream-state.json`:\n\nAdd domain-specific topics relevant to your work. The prompt should spark genuine exploration, not busywork.\n\n## Tuning\n\nIn `data/dream-state.json`:\n\n- **maxDreamsPerNight** — cap on dreams per night (default: 1)\n- **dreamChance** — probability per check (default: 1.0 = guaranteed if under limit)\n\nLower `dreamChance` for more sporadic dreaming. Raise `maxDreamsPerNight` for more prolific nights."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/briancolinger/dreaming",
    "publisherUrl": "https://clawhub.ai/briancolinger/dreaming",
    "owner": "briancolinger",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/dreaming",
    "downloadUrl": "https://openagent3.xyz/downloads/dreaming",
    "agentUrl": "https://openagent3.xyz/skills/dreaming/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dreaming/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dreaming/agent.md"
  }
}