update-skills

Capture repository learnings as reusable skills and instructions for future sessions.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/voidful/Aixlarity --skill update-skills-voidful
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-skills
Source: https://github.com/voidful/Aixlarity/tree/main/aixlarity-ide/src/vs/sessions/skills/update-skills
Command: npx skills add https://github.com/voidful/Aixlarity --skill update-skills-voidful

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Valuable insights discovered during a coding session—recurring patterns, non-obvious pitfalls, architectural constraints—are usually lost when the session ends. This Skill turns those discoveries into persistent skills and instruction files so future sessions benefit from the same knowledge. ## Core Features & Use Cases - Learning Capture: Triggered by the user saying "learn!" or by detecting a significant pattern, pitfall, or correction worth preserving. - Decision Framework: Guides whether to add a short learning to an existing instruction, create a standalone skill in .github/skills/ or .agents/skills/, or create an auto-applied instruction with applyTo glob patterns. - Quality Checks: Enforces that captured knowledge is general, actionable, includes concrete examples, and does not duplicate existing content. - Use Case: After spending an hour debugging a non-obvious build configuration issue, say "learn!" to have the root cause and correct approach written into a skill file that future sessions can invoke by name. ## Quick Start Say "learn!" after a significant discovery to capture the pattern or pitfall as a reusable skill or instruction file.

Frequently Asked Questions about update-skills

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

FAQPage Schema
How do I save a learning from an AI coding session?

Say "learn!" or ask the agent to capture the insight. The skill evaluates whether the knowledge fits an existing instruction file, warrants a new standalone skill, or should become an auto-applied instruction, then writes it to the appropriate location.

What is the difference between a skill and an instruction file?

A skill lives in `.github/skills/{name}/SKILL.md` or `.agents/skills/{name}/SKILL.md` and is invoked on demand by name. An instruction in `.github/instructions/` applies automatically based on `applyTo` glob patterns or globally, suiting coding conventions and process rules.

When should I add a learning to an existing file instead of creating a new skill?

Add to an existing file when the insight is small (1-4 sentences) and refines an existing guideline. Create a new skill when the knowledge is substantial, covers a distinct domain area, and should be invocable by name in future sessions.

Does the skill name need to match the folder name?

Yes. The `name` field in the SKILL.md frontmatter must exactly match the parent folder name, otherwise the skill will not be discovered correctly.

What makes a captured learning high quality?

A good learning is general enough to help future sessions, specific enough to be actionable, includes a concrete right-versus-wrong example, avoids duplicating existing content, and has a description clear enough that the agent knows when to invoke it.