ml-math-foundations

Derives and explains machine learning mathematics with rigorous notation, proofs, and intuition.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill ml-math-foundations-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ml-math-foundations
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/experimental/ml-math-foundations
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill ml-math-foundations-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering "why does this ML method work" requires rigorous derivations that are easy to get wrong or hand-wave. This Skill provides a structured workflow for producing mathematically rigorous, well-notated explanations and proofs of machine learning theory, with explicit assumptions and labeled rigor levels. ## Core Features & Use Cases - Step-by-step derivations: Backpropagation, optimizer update rules (SGD, momentum, Adam/AdamW), loss functions, attention/softmax math, and diffusion objectives with every symbol defined before use. - Theory coverage: Probability and statistics (MLE/MAP, bias-variance), optimization theory (convexity, convergence), information theory (entropy, KL divergence), and learning theory (generalization, PAC intuition). - Rigor discipline: Each step is labeled as proof, informal argument, or empirical fact, with sanity checks on shapes and limiting cases, plus citations to authoritative references like Goodfellow and Boyd. - Use Case: Ask why cross-entropy pairs with softmax on logits, and receive a full derivation from the likelihood, a gradient computation, intuition, and the practical implication for numerical stability. ## Quick Start Ask the agent to derive the backpropagation update rule for a two-layer network and explain why Adam's bias correction matters.

Frequently Asked Questions about ml-math-foundations

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

FAQPage Schema
How do I derive backpropagation step by step?

Define the network as a composition of layers with pre-activations and activations, write the loss, then apply the chain rule to get the output error term and the recurrence for earlier layers. Parameter gradients follow as outer products of error terms and previous activations, which is exactly reverse-mode automatic differentiation.

How to explain why an ML algorithm works mathematically?

Restate the claim with explicit assumptions, declare notation and tensor shapes, give a one-paragraph intuition, then derive the result step by step with each step labeled as proof, informal argument, or empirical fact. Finish with a sanity check on a degenerate case and the practical interpretation.

What math topics does this cover for machine learning?

It covers linear algebra, calculus, probability and statistics (MLE/MAP, bias-variance), optimization theory (convexity, gradient descent convergence), information theory (entropy, KL divergence, mutual information), and learning theory (generalization, VC/PAC intuition) as they apply to ML methods.

Can it prove convergence or generalization bounds?

Yes, it handles convergence proofs for gradient-based optimization and generalization or PAC-style intuition, stating assumptions like convexity or i.i.d. data explicitly. If a full proof is too long or uncertain, it says so and cites an authoritative source instead of fabricating results.

What are the limitations of informal mathematical explanations?

Informal arguments can hide broken assumptions such as non-differentiability or dependence between samples, so conclusions may not hold in practice. This Skill mitigates that by labeling rigor levels per step, checking limiting cases, and never presenting hand-waving as proof.