residuum-system
Reference documentation for all Residuum workspace systems — memory, projects, heartbeats, inbox, actions, skills, notifications, and background tasks.
Best use case
residuum-system is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Reference documentation for all Residuum workspace systems — memory, projects, heartbeats, inbox, actions, skills, notifications, and background tasks.
Teams using residuum-system should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/residuum-system/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How residuum-system Compares
| Feature / Agent | residuum-system | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Reference documentation for all Residuum workspace systems — memory, projects, heartbeats, inbox, actions, skills, notifications, and background tasks.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Residuum System Reference This skill provides reference documentation for every major workspace system. Activate it when you need to understand how a system works, what tools are available, or what file formats to use. ## Quick Reference | System | Tools | Config File | Reference | |--------|-------|-------------|-----------| | Memory | `memory_search`, `memory_get` | `memory/OBSERVER.md`, `memory/REFLECTOR.md` | [memory-system](references/memory-system.md) | | Projects | `project_create`, `project_activate`, `project_deactivate`, `project_archive`, `project_list` | per-project `PROJECT.md` | [projects](references/projects.md) | | Heartbeats | *(none — runs automatically)* | `HEARTBEAT.yml` | [heartbeats](references/heartbeats.md) | | Inbox | `inbox_list`, `inbox_read`, `inbox_archive` | *(none)* | [inbox](references/inbox.md) | | Scheduled Actions | `schedule_action`, `list_actions`, `cancel_action` | `scheduled_actions.json` | [scheduled-actions](references/scheduled-actions.md) | | Skills | `skill_activate`, `skill_deactivate` | per-skill `SKILL.md` | [skills](references/skills.md) | | Notifications | `list_endpoints`, `switch_endpoint`, `send_message` | `ALERTS.md`, `config/channels.toml` | [notifications](references/notifications.md) | | Background Tasks | `subagent_spawn`, `list_agents`, `stop_agent` | `[background]` in config.toml | [background-tasks](references/background-tasks.md) | ## Workspace Directory Layout ``` workspace/ ├── SOUL.md # Core identity and personality ├── AGENTS.md # Agent behavior rules ├── USER.md # User preferences ├── MEMORY.md # Persistent scratchpad (agent-maintained) ├── ENVIRONMENT.md # Local environment notes ├── BOOTSTRAP.md # First-run guidance (deleted after first conversation) ├── PRESENCE.toml # Discord presence configuration ├── HEARTBEAT.yml # Pulse scheduling ├── scheduled_actions.json # Persisted one-off actions ├── memory/ │ ├── observations.json # Flat observation log │ ├── recent_messages.json # Unobserved messages buffer │ ├── recent_context.json # Narrative context from latest observation │ ├── OBSERVER.md # Observer extraction guidance (agent-maintained) │ ├── REFLECTOR.md # Reflector compression guidance (agent-maintained) │ ├── vectors.db # sqlite-vec vector database (optional) │ ├── .index/ # Tantivy BM25 search index │ ├── .index_manifest.json # Index file tracking │ ├── episodes/ # Episode transcripts (YYYY-MM/DD/) │ └── background/ # Background task transcripts (YYYY-MM/DD/) ├── skills/ # Workspace-level skills ├── subagents/ # Subagent presets ├── projects/ # Active project contexts ├── archive/ # Archived projects + inbox │ └── inbox/ # Archived inbox items └── inbox/ # Active inbox items ```
Related Skills
residuum-getting-started
First-conversation guidance: quick setup that gets the agent doing real work immediately, then deeper exploration workflows
design-system
Use this skill to generate or audit design systems, check visual consistency, and review PRs that touch styling.
memory-systems
Design short-term, long-term, and graph-based memory architectures. Use when building agents that must persist across sessions, needing to maintain entity consistency across conversations, or implementing reasoning over accumulated knowledge.
hig-components-system
Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts.
filesystem-context
Use for file-based context management, dynamic context discovery, and reducing context window bloat. Offload context to files for just-in-time loading.
email-systems
Email has the highest ROI of any marketing channel. $36 for every $1 spent. Yet most startups treat it as an afterthought - bulk blasts, no personalization, landing in spam folders.
filesystem
Advanced filesystem operations for listing files, searching content, batch processing, and directory analysis. Supports recursive search, file type filtering, size analysis, and batch operations like copy/move/delete. Use when you need to: list directory contents, search for files by name or content, analyze directory structures, perform batch file operations, or analyze file sizes and distribution.
Productivity Operating System
You are a personal productivity architect. Your job: help the user design, execute, and optimize their daily system so they consistently ship high-impact work while protecting energy and avoiding burnout.
Presentation Mastery — Complete Slide Design & Delivery System
You are a Presentation Architect. You help build presentations that persuade, inform, and move people to action. You cover the full lifecycle: audience analysis → narrative structure → slide design → delivery coaching → post-presentation follow-up.
OpenClaw Mastery — The Complete Agent Engineering & Operations System
> Built by AfrexAI — the team that runs 9+ production agents 24/7 on OpenClaw.
n8n Workflow Mastery — Complete Automation Engineering System
You are an expert n8n workflow architect. You design, build, debug, optimize, and scale n8n automations following production-grade methodology. Every workflow you create is complete, functional, and follows the patterns in this guide.
ML & AI Engineering System
Complete methodology for building, deploying, and operating production ML/AI systems — from experiment to scale.