Self-learning skill for Claude: let the agent capture its own hard-won patterns

A new open-source meta-skill called 'self-learning' enables AI coding agents like Claude Code and Cursor to automatically capture and persist reusable workflows, commands, and project knowledge across sessions, preventing repeated rediscovery of hard-won patterns. The tool, available via the skills CLI, stores golden paths as skills or rules that auto-load in future sessions, while excluding secrets to avoid leaks.

A self-improving skill for AI coding agents. Works with Claude Code, Cursor, and any agent that reads an AGENTS.md / standing-instructions file. Every session you do hard debugging or rediscover the same thing — how do I reach the prod DB? where do the creds live? what's the deploy command? how do I verify this live? — and that hard-won knowledge evaporates when the session ends. The next session starts from zero and re-learns it. self-learning fixes that. It teaches your agent to recognize the moment it has just earned a reusable golden path and persist it where the tool will auto-load it next time — so the next session starts already knowing the route instead of rediscovering it. It's a meta-skill : it doesn't do the work, it captures how the work got done — including the failures , since skipping a known dead-end next session is often worth more than the win itself. Recognize the moment — a task that only worked after several tries, a non-obvious command, a project fact you didn't know up front, an operational workflow likely to recur, or you simply saying "remember this" . Capture it, no prompt needed — it acts on the cue immediately, picks the scope/name itself, and tells you afterward. The procedure is captured not a one-off answer , plus a "what didn't work" note. Reuse — next session the entry loads automatically, by skill/rule description or because the instructions file is always read. What differs per tool is only where knowledge is persisted and how it's auto-loaded: | Tool | Persists golden paths to | Auto-loads via | |---|---|---| | Claude Code / Agent Skills clients | a new skills/<name /SKILL.md | skill description matching | | Cursor | a new .cursor/rules/learned/<name .mdc | rule description / globs | | Codex, Zed, Aider, … | AGENTS.md or project notes/memory | always-read instructions | Uses the community skills https://github.com/vercel-labs/skills CLI, which installs into whatever agents it detects — Claude Code, Cursor, Codex, Cline, OpenCode, and more: npx skills add kulaxyz/self-learning-skills this project auto-detects agents npx skills add kulaxyz/self-learning-skills -g global — all your projects npx skills add kulaxyz/self-learning-skills -a claude-code a specific agent Try it once without installing: npx skills use kulaxyz/self-learning-skills --skill self-learning | claude /plugin marketplace add kulaxyz/self-learning-skills /plugin install self-learning@self-learning-skills Copy the files into place yourself git clone https://github.com/kulaxyz/self-learning-skills Claude Code — global or into a project's .claude/skills/ to share via git cp -R self-learning-skills/skills/self-learning ~/.claude/skills/ Cursor — auto-loads .cursor/rules/ harvested rules land in .cursor/rules/learned/ mkdir -p .cursor/rules cp self-learning-skills/.cursor/rules/self-learning.mdc .cursor/rules/ Any AGENTS.md agent Codex, Zed, Aider, Gemini CLI, … curl https://raw.githubusercontent.com/kulaxyz/self-learning-skills/main/AGENTS.md AGENTS.md It won't bloat your config with one-liners. Each lesson is routed: | Lesson | Where it goes | |---|---| A multi-step, reusable procedure/workflow | a new skill / rule | A single fact or one-line correction | lightweight notes/memory e.g. a MEMORY.md | A genuine one-off | skipped | Harvested skills/rules get committed and shared, so this is built to never write secret values — no passwords, tokens, connection strings, or API keys. It records only where to find a secret env var name, a client/selector function, an MCP tool, a secret manager . Reproducing a secret into a shared file leaks it. self-learning-skills/ ├── AGENTS.md generic, cross-tool version of the loop ├── skills.sh.json registry manifest for npx skills / skills.sh ├── .claude-plugin/ │ └── marketplace.json Claude Code plugin manifest ├── skills/ │ └── self-learning/ Agent Skills standard Claude Code + clients │ ├── SKILL.md recognize-the-moment + harvest procedure │ ├── references/ │ │ └── skill-authoring.md condensed spec the writer loads to author a good skill │ └── assets/ │ └── SKILL.template.md fill-in template for harvested skills └── .cursor/ └── rules/ ├── self-learning.mdc Cursor adapter always-applied rule └── learned/ harvested Cursor rules land here Built on the open Agent Skills https://agentskills.io standard. MIT /Kulaxyz/self-learning-skills/blob/main/LICENSE © kulaxyz