self-improvement

Capture operational learnings and errors into structured markdown logs.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/mashharuki/flare-sample --skill self-improvement-mashharuki
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-improvement
Source: https://github.com/mashharuki/flare-sample/tree/main/.claude/skills/self-improving-agent
Command: npx skills add https://github.com/mashharuki/flare-sample --skill self-improvement-mashharuki

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill provides a consistent, low-friction way to capture operational learnings, user corrections, command failures, and feature requests during AI-assisted development sessions so those insights are preserved, reviewed, and promoted into project memory or reusable skills.

Core Features & Use Cases

  • Structured Logging: Standardized markdown templates for LEARNINGS, ERRORS, and FEATURE_REQUESTS to keep entries uniform and searchable.
  • Hook-Based Detection: Lightweight hook scripts that remind agents to evaluate sessions and detect command/tool errors automatically.
  • Promotion Workflows: Guidance and scripts to promote recurring or high-value learnings into CLAUDE.md, AGENTS.md, or extracted skills for broader reuse.
  • Integration Scenarios: Use in interactive agent sessions, CI-assisted runs, or developer workspaces to capture post-task discoveries and recurring gotchas.

Quick Start

After finishing a task, log any error, correction, or useful insight to .learnings/LEARNINGS.md or .learnings/ERRORS.md using the provided template.

Frequently Asked Questions about self-improvement

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

FAQPage Schema
How do I automatically log errors and learnings from AI agent sessions into structured markdown?

To automatically log errors and learnings into structured markdown, this skill uses lightweight hook scripts that detect command failures and user corrections during agent sessions, writing them to standardized markdown templates in the .learnings directory.

What is the best way to capture user corrections and command failures during AI-assisted development?

The best way to capture user corrections and command failures is using hook-based detection scripts that automatically evaluate interactive agent sessions and log operational learnings into structured markdown files like LEARNINGS.md and ERRORS.md.

How do I promote recurring development learnings into project memory or reusable skills?

To promote recurring development learnings into project memory, this skill provides promotion workflows and scripts that elevate high-value entries from markdown logs into CLAUDE.md, AGENTS.md, or extracted skills for broader reuse.

Can I use hook scripts to detect tool errors in CI-assisted runs and developer workspaces?

Yes, you can use hook scripts to detect tool errors in CI-assisted runs and developer workspaces, as the skill is designed to capture post-task discoveries, recurring gotchas, and external tool errors across multiple integration scenarios.

What markdown templates are available for logging feature requests and operational errors?

Available markdown templates for logging feature requests and operational errors include standardized formats for LEARNINGS, ERRORS, and FEATURE_REQUESTS, keeping entries uniform and searchable across developer and agent sessions.

Does this skill require any external dependencies to capture operational learnings in agent sessions?

No, this skill requires no external dependencies to capture operational learnings in agent sessions, relying solely on lightweight internal hook scripts and markdown templates for error detection and structured logging.