self-improving-engineering

Log engineering learnings to markdown files in a centralized `.learnings` directory.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/jose-compu/self-improving-skills --skill self-improving-engineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-improving-engineering
Source: https://github.com/jose-compu/self-improving-skills/tree/main/self-improving-engineering
Command: npx skills add https://github.com/jose-compu/self-improving-skills --skill self-improving-engineering

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Engineering teams struggle to retain institutional knowledge about architecture decisions, build/log issues, code quality concerns, and recurring patterns. This skill provides a centralized, searchable log of learnings that can be promoted to ADRs, coding standards, and CI/CD runbooks.

Core Features & Use Cases

  • Centralized logging of architecture decisions, engineering issues, performance regressions, and dependency problems.
  • Promotes widely applicable learnings to ADRs, SOUL, and tooling guidelines.
  • Integrates with existing skill extraction workflows to create reusable knowledge across projects.

Quick Start

Log an engineering learning entry after a build or deployment issue, including root cause, impact, and suggested fix, and log to .learnings/ following the standard format.

Frequently Asked Questions about self-improving-engineering

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

FAQPage Schema
How do I log engineering learnings and build failures for future reference?

You log engineering learnings by capturing root causes, impacts, and suggested fixes into markdown files within a centralized `.learnings` directory. This records build failures, deployment issues, and code quality insights to establish repeatable improvement patterns across your engineering team.

What is the best way to capture architectural decisions and promote them to ADRs?

The best way to capture architectural decisions is logging them as markdown entries in a centralized `.learnings` directory. Widely applicable learnings can then be promoted to Architecture Decision Records, coding standards, and CI/CD runbooks to retain institutional knowledge and standardize engineering practices.

Can I integrate engineering learnings logging with CI pipelines and code reviews?

Yes, you can integrate engineering learnings logging across CI pipelines and code reviews. The system supports agent tooling and templates to standardize logging during production incidents and build deployments, interlinking related entries to track recurrence and enable continuous improvement.

How do I track recurring code quality issues and dependency problems across projects?

You track recurring code quality issues and dependency problems by logging them to a centralized `.learnings` directory where related entries are interlinked. This creates searchable knowledge across projects and integrates with skill extraction workflows to establish reusable improvement patterns.

Does logging deployment learnings require any specific dependencies or environment setup?

Logging deployment learnings requires no external dependencies. It operates by writing markdown files to a `.learnings` directory using provided scripts, references, and assets, allowing teams to standardize logging formats and integrate with existing agent tooling without additional environment setup.