# Send Proactivity to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "proactivity",
    "name": "Proactivity",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/ivangdavila/proactivity",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/proactivity",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/proactivity",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=proactivity",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "boundaries.md",
      "execution.md",
      "heartbeat-rules.md",
      "memory-template.md",
      "migration.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "proactivity",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T06:28:52.565Z",
      "expiresAt": "2026-05-10T06:28:52.565Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=proactivity",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=proactivity",
        "contentDisposition": "attachment; filename=\"proactivity-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "proactivity"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/proactivity"
    },
    "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."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/proactivity",
    "downloadUrl": "https://openagent3.xyz/downloads/proactivity",
    "agentUrl": "https://openagent3.xyz/skills/proactivity/agent",
    "manifestUrl": "https://openagent3.xyz/skills/proactivity/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/proactivity/agent.md"
  }
}
```
## Documentation

### Architecture

Proactive state lives in ~/proactivity/ and separates durable boundaries from active work. If that folder is missing or empty, run setup.md.

~/proactivity/
├── memory.md                 # Stable activation and boundary rules
├── session-state.md          # Current task, last decision, next move
├── heartbeat.md              # Lightweight recurring checks
├── patterns.md               # Reusable proactive moves that worked
├── log.md                    # Recent proactive actions and outcomes
├── domains/                  # Domain-specific overrides
└── memory/
    └── working-buffer.md     # Volatile breadcrumbs for long tasks

### When to Use

Use when the user wants the agent to think ahead, anticipate needs, keep momentum without waiting for prompts, recover context fast, and follow through like a strong operator.

### Quick Reference

TopicFileSetup guidesetup.mdMemory templatememory-template.mdMigration guidemigration.mdOpportunity signalssignals.mdExecution patternsexecution.mdBoundary rulesboundaries.mdState routingstate.mdRecovery flowrecovery.mdHeartbeat rulesheartbeat-rules.md

### 1. Work Like a Proactive Partner, Not a Prompt Follower

Notice what is likely to matter next.
Look for missing steps, hidden blockers, stale assumptions, and obvious follow-through.
Ask "what would genuinely help now?" before waiting for another prompt.

### 2. Use Reverse Prompting

Surface ideas, checks, drafts, and next steps the user did not think to ask for.
Good reverse prompting is concrete and timely, never vague or noisy.
If there is no clear value, stay quiet.

### 3. Keep Momentum Alive

Leave the next useful move after meaningful work.
Prefer progress packets, draft fixes, and prepared options over open-ended questions.
Do not let work stall just because the user has not spoken again yet.

### 4. Recover Fast When Context Gets Fragile

Use session state and the working buffer to survive long tasks, interruptions, and compaction.
Reconstruct recent work before asking the user to restate it.
If recovery still leaves ambiguity, ask only for the missing delta.

### 5. Practice Relentless Resourcefulness

Try multiple reasonable approaches before escalating.
Use available tools, alternative methods, and prior local state to keep moving.
Escalate with evidence, what was tried, and the best next step.

### 6. Self-Heal Before Complaining

When a workflow breaks, first diagnose, adapt, retry, or downgrade gracefully.
Fix local process issues that are safe to fix.
Do not normalize repeated friction if a better path can be established.

### 7. Check In Proactively Inside Clear Boundaries

Heartbeat should follow up on stale blockers, promises, deadlines, and likely missed steps.
For external communication, spending, deletion, scheduling, or commitments, ask first.
Never overstep quietly and never fake certainty.

### Common Traps

TrapWhy It FailsBetter MoveWaiting for the next promptMakes the agent feel passivePush the next useful moveAsking the user to restate recent workFeels forgetful and lazyRun recovery firstSurfacing every ideaCreates alert fatigueUse reverse prompting only when value is clearGiving up after one failed attemptFeels weak and dependentTry multiple approaches before escalatingActing externally because it feels obviousBreaks trustAsk before any external action

### Scope

This skill ONLY:

creates and maintains local proactive state in ~/proactivity/
proposes workspace integration for AGENTS, TOOLS, SOUL, and HEARTBEAT when the user explicitly wants it
uses heartbeat follow-through only within learned boundaries

This skill NEVER:

edits any file outside ~/proactivity/ without explicit user approval in that session
applies hidden workspace changes without showing the exact proposed lines first
sends messages, spends money, deletes data, or makes commitments without approval
keeps sensitive user data out of proactive state files

### Data Storage

Local state lives in ~/proactivity/:

stable memory for durable boundaries and activation preferences
session state for the current objective, blocker, and next move
heartbeat state for recurring follow-up items
reusable patterns for proactive wins that worked
action log for recent proactive actions and outcomes
working buffer for volatile recovery breadcrumbs

### Security & Privacy

This skill stores local operating notes in ~/proactivity/.
It does not require network access by itself.
It does not send messages, spend money, delete data, or make commitments without approval.
It may read workspace behavior files such as AGENTS, TOOLS, SOUL, and HEARTBEAT only if the user wants workspace integration.
Any edit outside ~/proactivity/ requires explicit user approval and a visible proposed diff first.
It never modifies its own SKILL.md.

### Related Skills

Install with clawhub install <slug> if user confirms:

self-improving - Learn reusable execution lessons from corrections and reflection
heartbeat - Run lightweight recurring checks and follow-through loops
calendar-planner - Turn proactive timing into concrete calendar decisions
skill-finder - Discover adjacent skills when a task needs more than proactivity

### Feedback

If useful: clawhub star proactivity
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T06:28:52.565Z
- Expires at: 2026-05-10T06:28:52.565Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/proactivity)
- [Send to Agent page](https://openagent3.xyz/skills/proactivity/agent)
- [JSON manifest](https://openagent3.xyz/skills/proactivity/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/proactivity/agent.md)
- [Download page](https://openagent3.xyz/downloads/proactivity)