phx:learn

Records bug-fix patterns and lessons learned into a central file.

517|35|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix --skill phx-learn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phx:learn
Source: https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/plugins/elixir-phoenix/skills/learn-from-fix
Command: npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix --skill phx-learn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps prevent recurring bugs and mistakes by systematically capturing and documenting lessons learned from code fixes and corrections.

Core Features & Use Cases

  • Knowledge Capture: Records the root cause, pattern, and example of a mistake.
  • Prevention: Updates a central knowledge base (references/common-mistakes.md) to guide future development.
  • Use Case: After fixing a tricky N+1 query, use /phx:learn to document the specific preload that was missed, ensuring the team avoids the same issue in the future.

Quick Start

Use the phx:learn skill to capture that string keys were used incorrectly in a map.

Frequently Asked Questions about phx:learn

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

FAQPage Schema
How do I document lessons learned from bug fixes in Elixir Phoenix?

Document lessons learned from Elixir Phoenix bug fixes by capturing the root cause, the incorrect pattern, and the correct code example. This process records specific mistakes like missed preloads to a central knowledge base for team-wide prevention.

What is the best way to prevent recurring code quality mistakes in a Phoenix project?

Preventing recurring code quality mistakes in a Phoenix project involves systematically documenting the root cause and incorrect patterns after a fix. Recording what to avoid and what to do instead updates a shared knowledge base to guide future development.

How does capturing common mistakes improve Elixir debugging workflows?

Capturing common mistakes improves Elixir debugging workflows by logging the root cause and clear patterns of previous errors into a central file. This documented knowledge base prevents the team from repeating the same debugging steps.

Can I record Elixir N+1 query fixes to prevent future preload errors?

Yes, you can record Elixir N+1 query fixes by documenting the specific missed preload that caused the issue. Capturing the root cause and code example ensures the team avoids the same preload errors in future development.

Does documenting code corrections require any external dependencies?

Documenting code corrections requires no external dependencies. The skill independently updates a central markdown knowledge base file with the root cause, patterns, and code examples from your fixes.