Agent skill

learn

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/akaihola/skills-akaihola/tree/main/learn

SKILL.md

learn

Reflect and extract learnings from the current conversation. Capture actionable lessons in the most appropriate durable form.

When to use

Use this skill when:

  • A task is complete and had interesting friction or discovery
  • The user asks you to reflect or says learn
  • You notice a repeated pattern worth capturing
  • Something took longer than it should have

Process

1. Reflect on the conversation

Ask yourself:

  • What did I do? (the task itself)
  • What went smoothly? (keep doing this)
  • What was friction? (manual steps, missing context, trial-and-error)
  • What knowledge was missing? (had to discover something that should have been known)
  • What will repeat? (this exact task or pattern will come up again)

2. Load project-specific guidance

Read LEARN.md or .claude/LEARN.md from the current workspace root if it exists. It overrides or extends the defaults below with project-specific capture locations (memory paths, backlog files, naming conventions, etc.).

3. Classify each learning

For each insight, decide the best capture format:

Format When to use Where it lives
Script Multi-step routine that will repeat exactly ~/bin/ or project bin/
Skill Capability needing instructions + judgment .claude/skills/<name>/SKILL.md
Memory note Fact, preference, lesson, context See LEARN.md for workspace-specific location
CLAUDE.md update Workflow pattern or convention CLAUDE.md
Improvement backlog Idea that needs discussion first See LEARN.md for workspace-specific location

4. Capture

  • Write the learning to the appropriate location (consult LEARN.md for workspace-specific paths)
  • For scripts: make them executable, add comments explaining purpose
  • For skills: follow the .claude/skills/<name>/SKILL.md pattern
  • For memory: be concise but include enough context for future-you

5. Report to user

Always tell the user what you learned, in this format:

markdown
## What I learned

**[Learning 1]**: [concise description]
→ Captured as: [script/skill/memory note] in `[path]`

**[Learning 2]**: [concise description]
→ Captured as: [script/skill/memory note] in `[path]`

If nothing meaningful was learned, say so honestly — don't fabricate insights.

Examples

After a build/deploy task:

"Mitto needs nix-shell -p gnumake go to build — neither make nor go are on PATH. Captured in memory." "The pull-build-install-restart cycle is a routine. Created ~/mitto/bin/rebuild.sh."

After debugging:

"The CSP nonce regression was caused by [X]. Added to memory so I check for this pattern next time."

After research:

"Found that library X requires config Y. Added to the project skill."

Constraints

  • Be honest — don't manufacture learnings for the sake of it
  • Prefer updating existing files over creating new ones
  • Scripts should be idempotent and safe to re-run
  • Always tell the user AND log to a file — both, not just one

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

akaihola/skills-akaihola

youtube-to-markdown

Convert a YouTube video into clean, readable Markdown using its free auto-generated captions (no paid API needed). Use when the user asks to "convert YouTube video to markdown", "get transcript from YouTube URL", "summarise this video", or wants to turn YouTube subtitles/captions into readable text. Prefer this over youtube-transcription when the video already has auto-generated subtitles — it's free and faster. Accepts YouTube URLs.

1 0
Explore
akaihola/skills-akaihola

brave-search

Search the web using Brave Search API. Use when the user asks to "search the web", "look up current information", "find news about", "research a topic online", "check prices online", or needs up-to-date facts that may not be in the model's training data. Requires BRAVE_SEARCH_API_KEY. Supports structured web results (pages, FAQs, news, videos) and an optional AI summarizer.

1 0
Explore
akaihola/skills-akaihola

verkkokauppa

Search products on the Verkkokauppa.com Finnish webshop. This skill uses the Verkkokauppa search API directly, requiring no browser. Use when the user asks to "search Verkkokauppa", "find products on verkkokauppa.com", "verkkokauppa product search", "check Verkkokauppa prices", or mentions searching the Verkkokauppa store.

1 0
Explore
akaihola/skills-akaihola

clasohlson

Search products on the Clas Ohlson Finland webshop (clasohlson.com/fi/). This skill uses the Voyado Elevate (Apptus eSales) search API directly, requiring no browser. Use when the user asks to "search Clas Ohlson", "find products on clasohlson.com", "clas ohlson product search", "check Clas Ohlson prices", or mentions searching the Finnish Clas Ohlson store.

1 0
Explore
akaihola/skills-akaihola

bauhaus

Search products on the Bauhaus webshop (bauhaus.fi). This skill uses the Algolia search API with automatic key refresh. Use when the user asks to "search Bauhaus", "find products on bauhaus.fi", "bauhaus product search", "check Bauhaus prices", or mentions searching the Bauhaus store.

1 0
Explore
akaihola/skills-akaihola

library

1 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results