learn

The agent's cross-session notebook at ~/.kinclaw/learned.md, organized by bundle_id / topic.

IndexedApache-2.0★ 9

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/localkinai-learn

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

The agent's cross-session notebook at ~/.kinclaw/learned.md, organized by bundle_id / topic. The kernel reads it at every boot and injects it into the system prompt (when it outgrows the prompt budget you see a topic index plus the newest notes — use action=recall for the rest). action=add (default) — append one lesson after a task: - AX schema quirks (depth needed, weird matchers) - Working keyboard / shell shortcuts that beat ui clicks - Failed approaches + their error codes (so you don't retry next time) - First-launch modal patterns - bundle_id spelling (some apps use lowercase like com.apple.mail) action=recall topic=X — print one section (case-insensitive match) action=list — print the topic index Appends go to a section keyed on `topic` (usually a bundle_id). Creates the section if it doesn't exist; appends bullet lines if it does. No-op if the exact same line already exists (idempotent).

Use cases: design, backend, productivity, finance

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/learn

What's inside

Skill name: learn
Description: The agent's cross-session notebook at ~/.kinclaw/learned.md, organized by bundle_id / topic. The kernel reads it at every boot and injects it into the system prompt (when it outgrows the prompt budget you see a topic index plus the newest notes — use action=recall for the rest). action=add (default) — append one lesson after a task: - AX schema quirks (depth needed, weird matchers) - Working keyboard / shell shortcuts that beat ui clicks - Failed approaches + their error codes (so you don't retry next time) - First-launch modal patterns - bundle_id spelling (some apps use lowercase like com.apple.mail) action=recall topic=X — print one section (case-insensitive match) action=list — print the topic index Appends go to a section keyed on `topic` (usually a bundle_id). Creates the section if it doesn't exist; appends bullet lines if it does. No-op if the exact same line already exists (idempotent).
License: Apache-2.0
Instructions: 33 lines in SKILL.md · view on GitHub

Files (1)

SKILL.md

SKILL.md (first lines)

# learn — append to the cross-session notebook

KinClaw's persistence layer for Genesis Protocol. Every successful
task or hard-won failure is an opportunity to make next session
smarter. This skill is the standardized way to write into
`~/.kinclaw/learned.md` — kernel auto-loads that file at boot and
injects it into the agent's system prompt. (Until v1.18 this skill wrote
to `~/.localkin/learned.md` while the kernel read `~/.kinclaw/` — the
kernel still reads the old file so nothing written there is lost.)

## Idempotent

Calling `learn` with the same topic + note twice is a no-op. Safe to
spam without polluting the notebook.

## Examples

```
learn topic=com.apple.calculator note="AX tree depth ≥ 6 to see number buttons"
learn topic=com.apple.Notes note="cmd+N more reliable than ui click 'New Note'"
learn topic=com.apple.reminders note="ui click description='Add Reminder' fails with AXError -25205; use cmd+N + type"
learn topic="Common: focus protection" note="osascript activate from Terminal-driven KinClaw rarely takes frontmost"
learn action=list
learn action=recall topic=com.apple.Notes
```

## Why a SKILL.md and not native

Pure shell + awk. No Go state. The notebook lives at a known path
that the kernel already reads — this skill is just an idempotent
append helper. Nothing here belongs in the kernel.

From LocalKinAI/kinclaw, Apache-2.0.

Signals

Stars: 9
Forks: 3
Open issues: 2
Last commit (this folder): Sep 6, 2026 (1 month ago)
Last release: Sep 6, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

License: Apache-2.0
Repository: github.com/LocalKinAI/kinclaw
Website: localkin.dev
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

More from LocalKinAI

Cite this page

learn skill. Agent Mart. https://agentmart.dev/skills/localkinai-learn (last updated 2026-10-24)