capture-learning

Document problem-solving narratives into structured Markdown files.

1|Updated Feb 6, 2026

Search Tags:#debugging #documentation #narrative #learning #problem-solving #knowledge capture

Ready to run

npx skills add https://github.com/skinnyandbald/fish-skills --skill capture-learning-skinnyandbald

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: capture-learning
Source: https://github.com/skinnyandbald/fish-skills/tree/main/skills/capture-learning
Command: npx skills add https://github.com/skinnyandbald/fish-skills --skill capture-learning-skinnyandbald

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, and includes scripts (resource) components.

What problem does it solve?

This Skill captures the complete narrative of problem-solving, including the initial problem, assumptions, discoveries, troubleshooting steps, the final solution, and key takeaways, preventing repeated mistakes and fostering knowledge sharing.

Core Features & Use Cases

Comprehensive Narrative Capture: Records a six-part story of problem-solving.
Knowledge Preservation: Saves learnings in a structured format for future reference.
Use Case: After debugging a complex issue, use this skill to document the entire process, ensuring that the lessons learned are preserved and easily accessible for future reference or for onboarding new team members.

Quick Start

Use the capture-learning skill to document the problem-solving journey you just completed.

Frequently Asked Questions about capture-learning

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

FAQPage Schema

How do I document my debugging process and problem-solving steps in Markdown?▼

To document debugging in Markdown, this Skill captures your problem-solving narrative by recording the problem, initial assumptions, troubleshooting steps, solution, and takeaway into a structured file. It saves these learnings directly in your project's .claude/learnings directory.

What is the best way to capture troubleshooting narratives to prevent repeated mistakes?▼

Capturing troubleshooting narratives prevents repeated mistakes by preserving the complete journey of discovery. This Skill records what you assumed versus actual reality and your final solution, fostering knowledge sharing for future reference or onboarding new team members.

Do I need Bun runtime to run scripts for saving session learnings?▼

Yes, you need the Bun runtime installed because this Skill requires it for script execution. The scripts capture your work session's problem-solving process and save it locally as structured Markdown documentation.

Where does the knowledge capture script save problem-solving documentation?▼

The knowledge capture script saves problem-solving documentation as a structured Markdown file in your project's .claude/learnings directory. If that directory is unavailable, it falls back to saving the file in the ~/.claude/learnings/ path.

What specific details does the problem-solving narrative capture from work sessions?▼

The problem-solving narrative captures six specific elements from work sessions: the initial problem, your initial assumption, the actual reality discovered, troubleshooting steps taken, the final solution, and key takeaways. This comprehensive format prevents knowledge loss.