Agent skill

Lesson Learned

by pedronauck in pedronauck/skills

Analyze recent code changes via git history and extract software engineering lessons.

No licenceAuto-check passedDevelopment

Install Lesson Learned

skills CLI
$ npx skills add pedronauck/skills --skill lesson-learned -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pedronauck/skills lesson-learned --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/curated/lesson-learned .claude/skills/lesson-learned && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
lesson-learned
GitHub stars
634
Used in
1 other repo
Token cost
~1.2k tokens
SKILL.md length
541 words
Files
4 (incl. references)
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Analyze recent code changes via git history and extract software engineering lessons.

  • Works in 4 steps: Determine Scope → Gather Changes → Analyze → …
  • The user asks what is the lesson here?
  • SKILL.md covers Before You Begin, Phase 1: Determine Scope, Phase 2: Gather Changes and Phase 3: Analyze, plus 3 more sections
  • Calls git

What it does

Lesson Learned is an agent skill from pedronauck/skills. Analyze recent code changes via git history and extract software engineering lessons. Use when the user asks 'what is the lesson here?', 'what can I learn from this?', 'engineering takeaway', 'what did I just learn?', 'reflect on this code', or wants to extract principles from recent work.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `README.md`, `references/anti-patterns.md` and `references/se-principles.md`).

It sits in Development, covering Git workflow. It works with Git. The repository describes itself as: My personal favorite skills.

When your agent uses it

  • The user asks what is the lesson here?
  • What can I learn from this?
  • Engineering takeaway
  • What did I just learn?

Example prompts

  • “what is the lesson here?”
  • “what can I learn from this?”
  • “engineering takeaway”
  • “/lesson-learned”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Determine Scope
  2. Gather Changes
  3. Analyze
  4. Present the Lesson

What it can do on your machine

Read from SKILL.md and the folder at commit 0422940. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lesson Learned loads about 1.2k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 76 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~76
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 541 words (~1,188 tokens).

“Extract specific, grounded software engineering lessons from actual code changes. Not a lecture -- a mirror. Show the user what their code already demonstrates.”

— opening of SKILL.md by pedronauck
name
lesson-learned

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in skills/curated/lesson-learned of pedronauck/skills.

  • SKILL.md
  • README.md
  • references/anti-patterns.md
  • references/se-principles.md

Open the folder on GitHubat commit 0422940

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in pedronauck/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Lesson Learned next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lesson Learned compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lesson Learned this skillpedronauck/skills6341 repos~1.2kAutomated safety check: PassNone
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost55k—~3.8kAutomated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    55k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Git Merge Conflict Resolver

    tailcallhq/forgecode

    Resolves Git merge conflicts with a plan-first workflow that keeps both sides' intent, regenerates lock files and backs up deleted-but-modified files.

    7.6k GitHub starsUsed in 1 repo~4.5k tokens
    DevelopmentAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 24 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 24 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 24 days ago
    Auto-check passed

Works with

Categories

Questions about Lesson Learned

What does Lesson Learned do?

Analyze recent code changes via git history and extract software engineering lessons. Lesson Learned is an agent skill from pedronauck/skills. Analyze recent code changes via git history and extract software engineering lessons.

When should I use Lesson Learned?

Lesson Learned fits situations like: the user asks what is the lesson here?; what can I learn from this?; engineering takeaway; what did I just learn?.

How do I install Lesson Learned in Claude Code?

Run `npx skills add pedronauck/skills --skill lesson-learned -a claude-code`. Or copy the skill folder (skills/curated/lesson-learned in pedronauck/skills) into .claude/skills/lesson-learned in your project. Claude Code loads it when a task matches its description.

How do I install Lesson Learned in Codex?

Run `npx skills add pedronauck/skills --skill lesson-learned -a codex`. Or copy the skill folder (skills/curated/lesson-learned in pedronauck/skills) into .agents/skills/lesson-learned in your project. Codex loads it when a task matches its description.

Can I use Lesson Learned in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pedronauck/skills --skill lesson-learned -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lesson-learned, .gemini/skills/lesson-learned, .github/skills/lesson-learned and .opencode/skills/lesson-learned in your project.

What does Lesson Learned need to run?

Going by SKILL.md and its folder, Lesson Learned needs the command-line tools its instructions call (git).

Does Lesson Learned access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Lesson Learned safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lesson Learned use?

No licence was found for Lesson Learned or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Lesson Learned use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.2k tokens, read only when the agent opens those files.

What are the alternatives to Lesson Learned?

Skills that share tags, products or a category with Lesson Learned: Finishing a Development Branch (obra/superpowers, 296k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Migrate Internal Package into Ghost (TryGhost/Ghost, 55k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lesson Learned?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

Source: pedronauck/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.