learn

Updates skill catalog SKILL.md definitions from conversation learnings and leaves changes uncommitted.

Updated Nov 2, 2025
One-click install
npx skills add https://github.com/fx/skills --skill learn-fx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: learn
Source: https://github.com/fx/skills/tree/main/skills/learn
Command: npx skills add https://github.com/fx/skills --skill learn-fx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an agent skill misbehaves, skips steps, or fails to load, the fix requires editing the correct SKILL.md in the catalog's git checkout — not an installed copy — and this skill locates the right tree, applies targeted edits, and leaves them uncommitted for review. ## Core Features & Use Cases - Catalog checkout resolution: Resolves the symlinked install path back to the git checkout, verifies the remote and working tree state, and refuses to edit stale --copy installs. - Targeted skill edits: Adds explicit prohibitions, missing workflow steps, and clarified instructions to SKILL.md files, including safe skill renames with cross-reference updates. - Uncommitted review workflow: Shows the git diff and leaves all changes uncommitted so a human reviews before committing. - Use Case: After a reviewer skill posts unwanted PR comments, invoke /learn to add an explicit prohibition to the relevant SKILL.md files, then review the diff and commit manually. ## Quick Start Invoke /learn and describe the misbehavior, for example: use /learn to update the pr-preparer skill so it always updates PROJECT.md when creating PRs.

Frequently Asked Questions about learn

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

FAQPage Schema
How do I update an agent skill after it misbehaves?▼

Invoke /learn and describe what went wrong and the desired behavior. The skill locates the relevant SKILL.md in the catalog checkout, adds targeted instructions or prohibitions, shows the git diff, and leaves changes uncommitted for your review.

How do I rename a skill in the catalog?▼

Use git mv to rename the directory, update the name field in its SKILL.md frontmatter, then grep the catalog for the old name to fix every cross-reference. Also check the new name against reserved names in AGENTS.md to avoid shadowing host agent built-ins.

Why did my skill edit have no effect after updating?▼

The edit likely landed in a --copy installed copy instead of the git checkout, so the next skills update silently reverts it. Resolve the installed path with readlink to find the real checkout, or run npx skills update after committing changes.

Can I edit skills installed with --copy directly?▼

No. Edits to copied installs are overwritten by the next skills update and never reach the repository. Clone the catalog, edit the checkout, and leave changes uncommitted for review exactly as the workflow requires.

Does the learn skill commit its changes automatically?▼

No. It deliberately leaves all modifications uncommitted, shows the git diff, and lists the changed files so you can review and commit manually when satisfied.