shard-writer

Define write-what-where memory contracts so routine runs persist findings across executions.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/JYeswak/grok_bot_playground --skill shard-writer-jyeswak
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shard-writer
Source: https://github.com/JYeswak/grok_bot_playground/tree/main/plugin/skills/shard-writer
Command: npx skills add https://github.com/JYeswak/grok_bot_playground --skill shard-writer-jyeswak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Routines that write nothing force every run to re-learn the same facts, repeat the same mistakes, and re-ask the owner the same questions. This Skill turns a stateless routine into one where each run writes a dated memory shard and the next run reads it back before acting. ## Core Features & Use Cases - Memory contract definition: Specifies the routine, its shard name and location, run cadence, and a write-what list of at most five categories (decisions, observations, open questions). - Retention and supersede rules: Dated entries, SUPERSEDED marking on contradicted findings, and a strict no-silent-deletion policy so the shard stays a memory rather than an unbounded archive. - Read-back verification: Validates the contract by requiring two writes that a later run demonstrably read and acted on, covering both steady-state and finding runs. - Use Case: A weekly vendor-watch routine keeps re-summarizing the same competitor changelog. Apply this Skill to give it a shard where each run records dated findings and open questions, so the next run opens by stating what it is acting on from last week. ## Quick Start Give my weekly vendor-watch routine a memory shard contract defining what it writes, where it writes, and how the next run reads it back.

Frequently Asked Questions about shard-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add memory to a recurring routine or scheduled task?▼

Define a write-what-where contract: name the routine, its owned shard location, run cadence, and at most five categories of what it records. Each run appends dated entries, and the next run opens by reading the shard and stating what it acts on.

What should a routine write into its memory shard?▼

Write decisions with dates, observations with their sources, and open questions with owners. Skip raw dumps and transcripts; a shard holds conclusions with pointers, and even a no-change run writes that the check happened.

Can multiple routines share one memory shard?▼

No. Each routine owns exactly one shard and no other routine writes there. Routines may read other shards, but cross-references name the shard and date without copying its contents.

Is it safe to store API keys or tokens in a routine memory shard?▼

Never. Shards and contracts contain variable names like ${ROUTINE_API_KEY} only, never values. Credentials, tokens, and account identifiers are explicitly prohibited from shard entries.

When should I not use routine memory shards?▼

Do not use shards for chat history, conversation summaries, cross-routine knowledge bases, or anything leaving the routine's own scope. The skill also never posts, sends, or publishes shard contents to any external surface.