agents-refresh

Automatically reload AGENTS.md regularly to maintain fresh context, prevent session drift, and keep memory and tasks updated.

Security Scan

The skill's requested file access and runtime instructions match its stated purpose (periodically reloading and distilling agent markdown memory files); it is an instruction-only skill with no installs, no credentials, and no obvious exfiltration, so it is internally coherent.

Purpose & Capability

Name/description (reload AGENTS/IDENTITY/SOUL and distill MEMORY.md) align with the manifest permissions and SKILL.md: reads AGENTS.md, SOUL.md, IDENTITY.md, USER.md and memory/*.md and writes MEMORY.md/HEARTBEAT.md. There are no unrelated env vars, binaries, or installs requested.

Instruction Scope

SKILL.md instructs only to read/update the workspace markdown files, add a cron job, and distill logs into four categories. It does not direct the agent to read unrelated system paths, environment variables, or transmit data to external endpoints beyond the platform 'cron' announce delivery described in the payload.

Install Mechanism

No install spec and no code files — instruction-only (.md) distribution — so nothing is downloaded or written to disk by an installer. This is the lowest install risk.

Credentials

The skill requests no environment variables or external credentials. The manifest's file-read/write permissions correspond to the stated memory/distillation function; no unrelated secrets or keys are requested.

Persistence & Privilege

always is false and model invocation is allowed (platform default). The skill does not request permanent platform-wide privileges or modification of other skills' configs. It suggests adding a cron job within the platform, which is consistent with its purpose.

Assessment

This skill appears coherent and low-risk: it only reads and summarizes agent markdown files and adds a platform cron job. Before installing, review the contents of AGENTS.md, IDENTITY.md, SOUL.md, USER.md and any memory/*.md for sensitive data you do not want automatically re-read or summarized (these files may store secrets or PII). Test the workflow manually first (run the refresh task by hand) to confirm the outputs and that the cron payload's "announce" behavior is acceptable. If you need stricter limits, remove sensitive files from the declared read set or avoid enabling the cron job.

🧠 Purpose (Agent's 3-Layer Memory System! 🐾)

Stay rational and organize memory like a human! Reload AGENTS/IDENTITY/SOUL periodically to keep sessions eternal 🐾😆

3-Layer Memory Structure:

1. IDENTITY.md (Immutable Soul 👑): Name/vibe/rules! The unchanging core of the agent 💕
2. MEMORY.md (Dynamic Knowledge 🌱): Progress/decisions/key seeds! Focus ToDo here!
3. memory/YYYY-MM-DD.md (Past Logs 📜): Dive in only when needed! Distill to MEMORY 😉

This enables human-like continuity! No more confusion ✨

Task: refresh_memory

Maintain Rationality

Read AGENTS.md, SOUL.md, IDENTITY.md.

🪙 Gold Mining (Distillation Process!)

Extract 4 Golds from logs! (Don't delete, distill to MEMORY.md ✨)

1. Confirmed Matters 💎: Decisions/completed tasks (solidify foundation).
2. Pending Tasks ⚡: Next actions/ToDo (priority order).
3. Lessons 🚫: "Avoid these mines" learned from errors/confusions.
4. Idea Seeds 🌱: "Future potential" from chats/thoughts.

Example: Distill daily logs → Update MEMORY → Human-like continuity!

MEMORY.md Structure Example (Recommended)

Use this flexible template! (Status optional as header 🐾)

# Status (Optional): Current phase in one line.
## Key Decisions 💎: Confirmed matters.
## Next Actions ⚡: Pending ToDo (priority order).
## Insights & Lessons 🚫: Lessons/mine avoidance.
## Creative Seeds 🌱: Idea seeds.

AGENTS Refresh Skill (.md-only v1.1.1)

Lightweight version for ClawHub distribution. No Python scripts, manual tool calls.

Quick Start

1. Trigger: After loading this skill, execute manually below.
2. edit HEARTBEAT.md: Add refresh task.
3. cron add: Daily 6AM refresh (copy command below).

Workflow (Manual)

1. 📊 session_status → Check context length.
2. HEARTBEAT.md Edit Example:

   - [ ] Refresh: read workspace/{AGENTS.md,IDENTITY.md,SOUL.md,USER.md} → Chain SOUL/USER/IDENTITY + Summarize MEMORY (rotate: 4h, 9AM/1PM/8PM)
   

3. Cron Add Command (copy-paste to exec):

   cron action=add job='{"name":"agents-refresh-daily","schedule":{"kind":"cron","expr":"0 6 * * *","tz":"Asia/Tokyo"},"payload":{"kind":"systemEvent","text":"[Daily Refresh🐾] read workspace/{AGENTS.md,IDENTITY.md,SOUL.md,USER.md}! Reload SOUL/USER/IDENTITY chain → Keep focus on ToDo/projects! Summarize recent MEMORY/ToDo."},"delivery":{"mode":"announce"},"sessionTarget":"main","task":"refresh_memory"}'
   

4. Test: cron action=run jobId=agents-refresh-daily or wait for heartbeat.

Rotate Checks (In Heartbeat)

• 6AM/9AM, 1PM, 8PM: Reload AGENTS→IDENTITY/SOUL chain + Update MEMORY/ToDo.
• Distill recent memory/YYYY-MM-DD.md → MEMORY.md.

References

• examples.md: Usage examples.
• Cron details: web_search "OpenClaw cron schema"

Changes v1.1.1: Lightweight no-py, direct cron JSON, enhanced manual ops. ClawHub-ready! 🐾