feat: add four relayfile workspace skills

[khaliqgant]

Summary

Adds four new skills documenting the relayfile workspace primitives referenced in the Just Give the Agent Files blog post:

• activity-summary — agents read digests/yesterday.md before crawling provider data for time-windowed activity questions. Cuts the canonical "what did I work on yesterday" task from ~25 tool calls to ~4.
• daily-digest — authoring contract for <mount>/digests/: window taxonomy (today.md, yesterday.md, YYYY-MM-DD.md, this-week.md, last-week.md), per-provider section format, adapter digest() exports, regeneration rules, determinism requirements.
• writeback-as-files — file-creation writeback contract: drop a JSON file at the canonical path, mount validates against sibling .schema.json, provider mutation lands within ~30s. Covers idempotency, relayfile writeback list, .relay/dead-letter/ recovery.
• workspace-layout — start at LAYOUT.md, then <provider>/.layout.md, then by-title/, by-id/, by-name/, by-edited/<date>/, by-state/ alias subtrees. The <identifier>__<uuid> filename convention with credit to Mirage for the shape.

Each skill is registered in prpm.json (@agent-relay/<name> at 1.0.0) and listed in the README's Published Skills table.

Companion PRs land the same four skills in relayfile/.claude/skills/ and in cloud/.claude/skills/ + cloud/.agents/skills/ (sandbox).

Test plan

• CI passes (lint / link-check / package validation)
• prpm install @agent-relay/activity-summary resolves the new package
• Spot-check that each SKILL.md frontmatter name matches the directory name and the prpm.json entry
• Confirm <identifier>__<uuid> references stay consistent across the four skills

🤖 Generated with Claude Code

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 5b3ee195-fa93-4803-bf9a-dfb4e58c7b5a

📥 Commits

Reviewing files that changed from the base of the PR and between 2296765 and 2927e41.

📒 Files selected for processing (6)

• README.md
• prpm.json
• skills/activity-summary/SKILL.md
• skills/daily-digest/SKILL.md
• skills/workspace-layout/SKILL.md
• skills/writeback-as-files/SKILL.md

---

📝 Walkthrough

Walkthrough

This PR introduces and registers four new relayfile agent skills (v1.0.0): activity-summary for time-windowed digest consumption, daily-digest for digest production contracts, writeback-as-files for JSON-based mutations, and workspace-layout for resource discovery. All skills are documented with complete guides, registered in prpm.json, and listed in the README.

Changes

New relayfile agent skills (v1.0.0)

Layer / File(s)	Summary
Activity-summary skill (digest-first activity queries) README.md, prpm.json, skills/activity-summary/SKILL.md	Skill for answering time-windowed activity questions by reading pre-computed digest files under <mount>/digests/ before exploring raw provider data. Documents digest directory structure, file format with per-provider Markdown sections and canonical links, usage workflow including digest selection and coverage verification, fallback conditions for unusual windows or missing digests, and expected reduction in tool turns/calls.
Daily-digest skill (digest authoring contract) prpm.json, skills/daily-digest/SKILL.md	Skill authoring contract defining the digest production system. Specifies digest file taxonomy and window mutability, required header fields (window, providers, events), per-provider section format with ordered bullets linked to canonical mount paths, adapter async digest(ctx: DigestContext) function signature returning DigestSection or null, regeneration rules for rolling vs closing windows, and common authoring mistakes (determinism, canonical linking, no inlined payloads, no cross-provider summarization).
Writeback-as-files skill (JSON-based mutations) prpm.json, skills/writeback-as-files/SKILL.md	Skill for performing provider mutations via relayfile by writing canonical JSON payloads to designated writeback paths. Documents discovery of writeback directories, schema validation using sibling .schema.json files, wb-<timestamp>.json naming conventions for idempotency and retry friendliness, CLI commands for monitoring writeback status, dead-letter recovery from <mount>/.relay/dead-letter/ with .error.json replay metadata, and worked examples for Linear (comments), GitHub (issues), Slack (messages), and Notion (page updates).
Workspace-layout skill (resource discovery) prpm.json, skills/workspace-layout/SKILL.md	Skill for discovering and looking up resources on a relayfile mount. Defines the three-step lookup procedure: read root $MOUNT/LAYOUT.md, read provider $MOUNT/<provider>/.layout.md, then use by-* alias indexes instead of recursive search. Specifies filename convention <identifier>__<uuid>.<ext> with __ reserved, includes concrete command examples across Notion, Linear, and Slack, and explicitly forbids anti-patterns (grep -r, hardcoded paths, ignoring .layout.md).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related issues

• AgentWorkforce/relayfile#107: This PR directly implements the .skills/ proposal by introducing and packaging the activity-summary, daily-digest, writeback-as-files, and workspace-layout skills as documented SKILL.md files.

Possibly related PRs

• AgentWorkforce/skills#30: Both PRs document relayfile writeback discovery and schema/adapter workflows; PR #30 covers setup guidance while this PR provides the complete writeback-as-files skill contract and provider-specific examples.

Poem

A rabbit hops through skills today,
Four friends in relay-file's way,
Activity and digest bloom,
Writeback dances; layout zooms,
New workflows hop, hooray, hooray! 🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'feat: add four relayfile workspace skills' accurately and clearly summarizes the main change—adding four new skill documentation files (activity-summary, daily-digest, writeback-as-files, workspace-layout) to the repository.
Description check	✅ Passed	The description provides detailed context about the four new skills, their purpose, how they relate to the referenced blog post, and includes a thorough test plan—all directly aligned with the changeset's additions to prpm.json, README.md, and the four SKILL.md files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch add-relayfile-workspace-skills

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 1 additional finding.