Agent skill
memory
Read-side memory operations: search, recall, load, sync, history, visualize. Use when searching past decisions, loading session context, or viewing the knowledge graph.
Install this agent skill to your Project
npx add-skill https://github.com/yonatangross/orchestkit/tree/main/plugins/ork/skills/memory
Metadata
Additional technical details for this skill
- category
- mcp-enhancement
- mcp server
- memory
SKILL.md
Memory - Read & Access Operations
Unified read-side memory skill with subcommands for searching, loading, syncing, history, and visualization.
Argument Resolution
SUBCOMMAND = "$ARGUMENTS[0]" # First token: search, load, history, viz, status
QUERY = "$ARGUMENTS[1]" # Second token onward: search query or flags
# $ARGUMENTS is the full string (CC 2.1.59 indexed access)
Usage
/ork:memory search <query> # Search knowledge graph
/ork:memory load # Load context at session start
/ork:memory history # View decision timeline
/ork:memory viz # Visualize knowledge graph
/ork:memory status # Show memory system health
CRITICAL: Use AskUserQuestion When No Subcommand
If invoked without a subcommand, ask the user what they want:
AskUserQuestion(
questions=[{
"question": "What memory operation do you need?",
"header": "Operation",
"options": [
{"label": "search", "description": "Search decisions and patterns in knowledge graph", "markdown": "```\nSearch Knowledge Graph\n──────────────────────\n query ──▶ mcp__memory ──▶ results\n\n Flags:\n --category Filter by type\n --agent Scope to agent\n --limit N Max results\n --global Cross-project\n```"},
{"label": "load", "description": "Load relevant context for this session", "markdown": "```\nLoad Session Context\n────────────────────\n Auto-detect project ──▶\n ┌────────────────────┐\n │ Recent decisions │\n │ Active patterns │\n │ Project entities │\n └────────────────────┘\n Flags: --project, --global\n```"},
{"label": "history", "description": "View decision timeline", "markdown": "```\nDecision Timeline\n─────────────────\n ┌──── Feb 28 ────────────┐\n │ Used Postgres over Mongo│\n ├──── Feb 27 ────────────┤\n │ Adopted MVC pattern │\n ├──── Feb 26 ────────────┤\n │ Chose JWT over sessions │\n └────────────────────────┘\n Flags: --since, --mermaid\n```"},
{"label": "viz", "description": "Visualize knowledge graph as Mermaid", "markdown": "```\nKnowledge Graph Viz\n───────────────────\n Entities ──▶ Mermaid diagram\n\n [Project] ──uses──▶ [Postgres]\n │ │\n └──has──▶ [Auth] ──uses──▶ [JWT]\n\n Output: Mermaid code block\n```"},
{"label": "status", "description": "Check memory system health", "markdown": "```\nMemory Health Check\n───────────────────\n ┌─────────────────────┐\n │ MCP server ✓/✗ │\n │ Entity count N │\n │ Relation count N │\n │ Last write date │\n │ Graph size N KB │\n └─────────────────────┘\n```"}
],
"multiSelect": false
}]
)
Subcommands
Load details: Read("${CLAUDE_SKILL_DIR}/references/memory-commands.md") for full usage, flags, output formats, and context-aware result limits for each subcommand.
| Subcommand | Purpose |
|---|---|
search |
Search past decisions, patterns, entities. Supports --category (maps to metadata.category), --limit, --agent (scopes by agent_id), --global filter flags |
load |
Auto-load relevant memories at session start. Supports --project, --global |
history |
Decision timeline with table, Mermaid, or JSON output. Supports --since, --mermaid |
viz |
Render knowledge graph as Mermaid diagram. See also Read("${CLAUDE_SKILL_DIR}/references/mermaid-patterns.md") |
status |
Memory system health check |
Workflow
1. Parse Subcommand
Extract first argument as subcommand
If no subcommand -> AskUserQuestion
Validate subcommand is one of: search, load, history, viz, status
Parse remaining flags
Check for --agent <agent-id> flag → agent_id: "ork:{agent-id}"
2. Execute Subcommand
Route to appropriate handler based on subcommand.
3. Report Results
Format output appropriate to the operation.
Rules Quick Reference
| Rule | Impact | What It Covers |
|---|---|---|
entity-extraction-patterns (load ${CLAUDE_SKILL_DIR}/rules/entity-extraction-patterns.md) |
HIGH | Entity types, relation types, graph query semantics |
deduplication-strategy (load ${CLAUDE_SKILL_DIR}/rules/deduplication-strategy.md) |
HIGH | Edit-over-Write pattern, anchor-based insertion, verification |
Session Resume
Load details: Read("${CLAUDE_SKILL_DIR}/references/session-resume-patterns.md") for CC 2.1.31 resume hints, context capture before ending, and resume workflows for PRs, issues, and implementations.
Related Skills
ork:remember- Store decisions and patterns (write-side)
Error Handling
- If graph empty for viz: Show helpful message about using /ork:remember
- If subcommand invalid: Show usage help
- If memory files corrupt: Report and offer repair
- If search query empty: Show recent entities instead
- If no search results: Suggest alternatives
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
expect
Diff-aware AI browser testing — analyzes git changes, generates targeted test plans, and executes them via agent-browser. Reads git diff to determine what changed, maps changes to affected pages via route map, generates a test plan scoped to the diff, and runs it with pass/fail reporting. Use when testing UI changes, verifying PRs before merge, running regression checks on changed components, or validating that recent code changes don't break the user-facing experience.
github-operations
GitHub CLI operations for issues, PRs, milestones, and Projects v2. Covers gh commands, REST API patterns, and automation scripts. Use when managing GitHub issues, PRs, milestones, or Projects with gh.
chain-patterns
Chain patterns for CC 2.1.71 pipelines — MCP detection, handoff files, checkpoint-resume, worktree agents, CronCreate monitoring. Use when building multi-phase pipeline skills. Loaded via skills: field by pipeline skills (fix-issue, implement, brainstorm, verify). Not user-invocable.
storybook-mcp-integration
Storybook MCP server integration for component-aware AI development. Covers 6 tools across 3 toolsets (dev, docs, testing): component discovery via list-all-documentation/get-documentation, story previews via preview-stories, and automated testing via run-story-tests. Use when generating components that should reuse existing Storybook components, running component tests via MCP, or previewing stories in chat.
component-search
Search 21st.dev component registry for production-ready React components. Finds components by natural language description, filters by framework and style system, returns ranked results with install instructions. Use when looking for UI components, finding alternatives to existing components, or sourcing design system building blocks.
ai-ui-generation
AI-assisted UI generation patterns for json-render, v0, Bolt, and Cursor workflows. Covers prompt engineering for component generation, review checklists for AI-generated code, design token injection, refactoring for design system conformance, and CI gates for quality assurance. Use when generating UI components with AI tools, rendering multi-surface MCP visual output, reviewing AI-generated code, or integrating AI output into design systems.
Didn't find tool you were looking for?