skills.rest
Overlord-Z
Overlord-ZCOMMUNITY
Explore all skills by this author →
GitHub

oracle

Maintain persistent project memory across Claude Code sessions.

1|Updated Nov 19, 2025
Search Tags:#code quality#automation#developer tools#context management#project memory#knowledge base#learning system
One-click install
npx skills add https://github.com/Overlord-Z/ClaudeShack --skill oracle-overlord-z
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oracle
Source: https://github.com/Overlord-Z/ClaudeShack/tree/main/skills/oracle
Command: npx skills add https://github.com/Overlord-Z/ClaudeShack --skill oracle-overlord-z

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Oracle solves the critical problem of context loss and repetitive mistakes in AI-assisted development. It prevents valuable learnings from being forgotten across sessions, eliminates the need to re-explain project specifics, and reduces wasted tokens by providing intelligent, relevant context. This accelerates development, improves code quality, and ensures AI works efficiently for you.

Core Features & Use Cases

  • Intelligent Context Injection: Automatically loads project-specific patterns, preferences, gotchas, and corrections at session start or for specific tasks, ensuring Claude is always context-aware and productive.
  • Learning from Corrections: When you correct Claude, Oracle records the mistake and the right approach, preventing recurrence and continuously improving AI performance and accuracy.
  • Session Recording & Timeline: Tracks all interactions, changes, decisions, and learnings, building a comprehensive, searchable project history that serves as institutional knowledge.
  • Automation Opportunities: Analyzes session history to detect repeated tasks and suggests or generates scripts for automation, saving time and tokens on deterministic operations.
  • Use Case: A developer frequently makes a specific error in React state management. Oracle, after being corrected once, records this as a "correction" with high priority. In subsequent sessions, when the developer works on React components, Oracle proactively injects this correction into the context, reminding Claude (and the developer) of the best practice, thus preventing the mistake from happening again and saving valuable debugging time.

Quick Start

To initialize Oracle for your project: python .claude/skills/oracle/Scripts/init_oracle.py To record what you learned after a session: python .claude/skills/oracle/Scripts/record_session.py --interactive To load relevant context for your next session: python .claude/skills/oracle/Scripts/load_context.py

Frequently Asked Questions about oracle

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

FAQPage Schema
How do I prevent losing context and project knowledge across Claude Code sessions?▼

Context loss across sessions wastes tokens and repeats mistakes. Oracle maintains persistent project memory by recording patterns, corrections, and lessons learned, then automatically injecting relevant context at session start. Initialize with `python .claude/skills/oracle/Scripts/init_oracle.py` to begin building your project knowledge base.

Can I record and track corrections Claude makes so I don't repeat the same mistakes?▼

Yes. Oracle records mistakes and corrections as high-priority learnings. When you correct Claude on a specific error—like React state management—Oracle stores it and proactively injects that correction into future sessions, preventing recurrence and improving accuracy over time.

How do I automate repetitive development tasks using session history?▼

Oracle analyzes your session history to detect repeated tasks and suggests script generation for automation. Run `python .claude/skills/oracle/Scripts/record_session.py --interactive` after sessions to log learnings, then use detected patterns to create scripts that save time and tokens on deterministic operations.

What's the best way to organize project-specific patterns and preferences for AI-assisted development?▼

Oracle structures knowledge into categories—patterns, preferences, gotchas, and solutions—with tiered context loading. This categorized storage ensures Claude receives only relevant context for each task, improving productivity while reducing wasted tokens and eliminating the need to re-explain project specifics.

Can Oracle work with CI workflows and script-based automation?▼

Yes. Oracle integrates with script-based automation and CI workflows through session hooks and context injection. Load relevant context for specific tasks using `python .claude/skills/oracle/Scripts/load_context.py`, enabling consistent AI assistance across development pipelines and automated processes.

Does Oracle create a searchable history of development decisions and changes?▼

Yes. Oracle's session recording tracks all interactions, changes, decisions, and learnings, building a comprehensive searchable project timeline. This institutional knowledge prevents duplicate work and serves as a reference for understanding why past decisions were made.

Related Skills

Explore More Software Engineering Skills→
mahg-esmahg-es
3

organizational-knowledge

Capture and organize ARAYA standards, ADRs, lessons learned, and technology preferences.

Official
Intermediate
adiytharpansaadiytharpansa

knowledge-synthesizer

Synthesizes fragmented conversations, memories, and learning records into connected insights and patterns.

Community
Intermediate
zachmayerzachmayer
2

knowledge-system

Routes inputs to daily memory logs, Obsidian vault notes, or GitHub issues.

Community
Advanced
ngquaanghuyngquaanghuy

memory-curator

Automate daily activity capture and session preservation through local scripts and reference files.

Community
Intermediate