name: learning-documentation-skill description: Document learning insights and activities to Supabase with proper categorization, formatting, and retrieval patterns

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](url)
- [Source 2](url)

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

1. Consistent Taxonomy: Always use standard categories
2. JSON Structure: Structured data > plain text
3. Action Items: Extract and track actionable insights
4. No Duplicates: Search before inserting
5. Future Self: Write for searchability later