Oracle Teach Skill

Transform mature knowledge into teachable materials

Purpose

Oracle-teach generates learning materials from patterns that have reached 🌿 Pattern level or higher. It's the "สร้างคน" output — taking what we've learned and making it transferable.

Proactive Triggers

MUST Use Teach When:

Knowledge Transfer:

• User says: "teach me about", "explain the pattern"
• User says: "how does X work", "why do we do X"
• User says: "create a guide for", "document this"

Team Sharing:

• Onboarding new team member
• Writing documentation
• Creating training materials

Pattern Explanation:

• User asks about established pattern
• Need to justify a decision
• Explaining "why we do it this way"

Teaching Formats

Quick Explanation

## Pattern: [Name]

**What**: One-line description
**Why**: The reasoning behind it
**How**: Steps to apply
**Example**: Concrete use case

Full Guide

# Guide: [Topic]

## Overview
What this pattern/principle is about.

## Background
Why this emerged, what problem it solves.

## The Pattern
Step-by-step application.

## Examples
### Example 1: [Context]
[Walkthrough]

### Example 2: [Context]
[Walkthrough]

## Common Mistakes
- Mistake 1: Why it's wrong
- Mistake 2: Why it's wrong

## Related Patterns
- [Link to related]

## Source
From Oracle knowledge base, maturity level: 🌿/🌳/🔮

Micro-lesson (60 seconds)

## 60-Second Lesson: [Topic]

**The Rule**: [One sentence]

**Why It Matters**: [One sentence]

**Try This**: [One action]

**Remember**: [Mnemonic or key phrase]

Teaching Workflow

1. Find Teachable Knowledge

oracle_search({
  type: "pattern",  // or principle, wisdom
  limit: 10
})
// Filter for teachable: true or maturity >= 🌿

2. Choose Format

| Audience | Format | Length | |----------|--------|--------| | Quick reminder | Micro-lesson | 60 sec | | Team member | Quick explanation | 2 min | | New hire | Full guide | 10 min | | Documentation | Full guide + examples | 15 min |

3. Generate Material

User: "teach me about subagent delegation"

AI checks Oracle → finds 🌿 Pattern "Subagent Delegation"

AI generates:
## Pattern: Subagent Delegation

**What**: Use Haiku subagents for bulk operations, Opus for review
**Why**: Saves context tokens, parallel execution, cost efficiency
**How**:
1. Identify bulk task (5+ files, heavy search)
2. Spawn subagent with clear instructions
3. Let subagent return summary
4. Main agent reviews and acts

**Example**: Searching 50 files for a pattern
- ❌ Main agent reads all 50 files (expensive)
- ✅ Subagent searches, returns top 5 matches

Integration with Oracle Ecosystem

| Skill | Relationship | |-------|--------------| | oracle | Source of patterns to teach | | oracle-incubate | Only teach mature knowledge (🌿+) | | oracle-path | Teach is building block for paths | | oracle-mentor | Mentor uses teach for guidance |

Teachability Criteria

| Level | Teachable? | Confidence | |-------|------------|------------| | 🥒 Observation | No | Too raw | | 🌱 Learning | Maybe | With caveats | | 🌿 Pattern | Yes | Proven | | 🌳 Principle | Definitely | Universal | | 🔮 Wisdom | Core teaching | Foundational |

Output Locations

| Material | Where | |----------|-------| | Quick explanation | Inline response | | Full guide | ψ/memory/learnings/ | | Team docs | Project /docs/ | | Training | ψ/writing/guides/ |

Quick Reference

| User Says | Action | |-----------|--------| | "teach me about X" | Find pattern, generate explanation | | "create a guide for X" | Full guide format | | "quick explanation of X" | Micro-lesson format | | "document this for team" | Full guide to /docs/ | | "why do we do X" | Find principle, explain reasoning |