Learning Documentation Skill

Systematically documents learning activities, insights, and knowledge to Life OS Supabase database.

When to Use This Skill

• After completing learning activity (video, article, course)

• Documenting insights from experiments

• Storing reference material for future use

• Building knowledge base over time

• Creating searchable learning archive

Supabase Structure

Table: insights

Location: mocerqjnksmhcjzxrewo.supabase.co

Required Fields:

• category : Primary classification

• subcategory : Secondary classification

• title : Brief descriptive title

• content : Main content (JSON for structured data)

• metadata : Additional context (optional)

Category Taxonomy

Primary Categories

learning:

• Subcategories: youtube_transcript, article, book, course, experiment

• Use: General knowledge acquisition

michael_swim:

• Subcategories: recruiting, meet_results, training, nutrition

• Use: Michael's swimming-related activities

mcp_reference:

• Subcategories: architecture, claude_skills, integration_patterns

• Use: MCP and Claude technical documentation

business:

• Subcategories: biddeed_ai, everest_capital, strategy

• Use: Business insights and decisions

adhd:

• Subcategories: task_patterns, interventions, productivity

• Use: ADHD management insights

family:

• Subcategories: shabbat, holidays, events

• Use: Family activities and observances

YouTube Transcript Documentation

When: After youtube_transcript.yml workflow completes

Format:

{ "category": "learning", "subcategory": "youtube_transcript", "title": "Claude Skills Tutorial - 6 Essential Skills", "content": { "video_id": "thxXGxYIwUI", "video_url": "https://youtu.be/thxXGxYIwUI", "transcript_summary": "Tutorial on 6 Claude skills: frontend-design, domain-brainstormer, stripe-integration, content-writer, lead-research, skill-creator", "key_takeaways": [ "Skills only load when needed (memory efficient)", "Progressive disclosure: ~100 tokens metadata, <5k when active", "Can build custom skills using skill-creator" ], "action_items": [ "Deploy 6 base skills to both repos", "Build custom foreclosure-analysis-skill", "Create ADHD task management skill" ], "source": "apify" }, "metadata": { "duration_minutes": 15, "watched_date": "2025-12-25", "relevance": "high" } }

Article/Blog Documentation

Format:

{ "category": "learning", "subcategory": "article", "title": "MCP Architecture Deep Dive", "content": { "url": "https://example.com/mcp-architecture", "author": "Anthropic", "published_date": "2025-01-15", "key_concepts": [ "Tool-based architecture", "Progressive disclosure", "Context injection patterns" ], "quotes": [ "Skills are prompt templates that inject domain-specific instructions" ], "personal_notes": "This explains why skills are more efficient than rules" } }

Experiment/Test Documentation

Format:

{ "category": "business", "subcategory": "biddeed_ai", "title": "Smart Router V5 Performance Test", "content": { "experiment_date": "2025-12-24", "hypothesis": "Gemini 2.5 Flash can handle 40-55% of requests", "methodology": "Run 100 auction analyses, track FREE vs PAID tier usage", "results": { "free_tier_percentage": 52, "paid_tier_percentage": 48, "cost_savings": "$28/month" }, "conclusion": "Target achieved, deploying to production", "next_steps": [ "Monitor for 1 week", "Adjust thresholds if needed" ] } }

Michael Swimming Documentation

Meet Results:

{ "category": "michael_swim", "subcategory": "meet_results", "title": "Harry Meisel Meet - December 2025", "content": { "meet_name": "Harry Meisel Invitational", "date": "2025-12-13", "location": "Orlando, FL", "results": [ { "event": "50 Free", "time": "21.85", "place": 3, "improvement": "-0.15 from previous" }, { "event": "100 Free", "time": "47.92", "place": 5, "improvement": "-0.32 from previous" } ], "notes": "Strong performance, time drops across all events", "coach_notifications": ["UF", "FSU", "NC State"] } }

Recruiting Activity:

{ "category": "michael_swim", "subcategory": "recruiting", "title": "Coach Outreach - University of Florida", "content": { "university": "University of Florida", "coach_name": "Anthony Nesty", "contact_date": "2025-12-20", "type": "initial_email", "response_received": false, "follow_up_date": "2026-01-03" } }

Markdown Formatting Standards

For content field (when storing markdown):

Title

Key Points

• Point 1
• Point 2

Takeaways

1. First takeaway
2. Second takeaway

Action Items

• Action 1
• Action 2

References

• Source 1
• Source 2

Keep it clean:

• Use headers (##) for sections

• Use bullet points for lists

• Use checkboxes for action items

• Include URLs for references

• NO excessive formatting

Insertion Workflow

Via GitHub Actions (Recommended)

BidDeed.AI repo:

workflow: .github/workflows/insert_insight.yml inputs: category: "mcp_reference" subcategory: "claude_skills" title: "Phase 1 Skills Deployed" content: "{json_content}"

Life OS repo:

workflow: .github/workflows/insert_insight.yml inputs: category: "learning" subcategory: "youtube_transcript" title: "Video Title" content: "{json_content}"

Direct Supabase Insert (Use Sparingly)

Only when GitHub Actions not available:

import requests

response = requests.post( "https://mocerqjnksmhcjzxrewo.supabase.co/rest/v1/insights", headers={ "apikey": "YOUR_ANON_KEY", "Content-Type": "application/json" }, json={ "category": "learning", "subcategory": "article", "title": "Example Title", "content": {"key": "value"} } )

Retrieval Patterns

Search by category:

SELECT * FROM insights WHERE category = 'learning' ORDER BY created_at DESC LIMIT 10

Search by keywords:

SELECT * FROM insights WHERE title ILIKE '%claude skills%' OR content::text ILIKE '%claude skills%'

Recent activity:

SELECT category, subcategory, title, created_at FROM insights WHERE created_at > NOW() - INTERVAL '7 days' ORDER BY created_at DESC

Best Practices

DO:

• ✓ Use consistent category/subcategory

• ✓ Write descriptive titles

• ✓ Structure content as JSON when possible

• ✓ Include action items when relevant

• ✓ Tag for future searchability

DON'T:

• ✗ Duplicate entries (check before inserting)

• ✗ Use vague titles ("Notes", "Misc")

• ✗ Store sensitive data (API keys, passwords)

• ✗ Overwrite existing valuable entries

• ✗ Insert empty or placeholder content

Example Usage

"Use learning-documentation-skill to log the Claude skills video transcript"

"Document experiment results for Smart Router V5"

"Log Michael's meet results from Harry Meisel"

Integration with Other Skills

After youtube_transcript workflow:

1. Transcript generated
2. Use learning-documentation-skill
3. Log to Supabase insights table
4. Category: learning, subcategory: youtube_transcript

After task completion:

1. Task marked COMPLETED
2. Use learning-documentation-skill
3. Log patterns/insights discovered
4. Category: adhd, subcategory: task_patterns

Critical Reminders

• Consistent Taxonomy: Always use standard categories

• JSON Structure: Structured data > plain text

• Action Items: Extract and track actionable insights

• No Duplicates: Search before inserting

• Future Self: Write for searchability later