update-skills

Capture repository learnings as persistent skills or instruction files for future sessions.

Updated Aug 20, 2026
One-click install
npx skills add https://github.com/basedgod55hjl/vsbrax --skill update-skills-basedgod55hjl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-skills
Source: https://github.com/basedgod55hjl/vsbrax/tree/main/src/vs/sessions/skills/update-skills
Command: npx skills add https://github.com/basedgod55hjl/vsbrax --skill update-skills-basedgod55hjl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Valuable insights discovered during a coding session — recurring patterns, non-obvious pitfalls, architectural constraints — are lost when the session ends. This Skill provides a structured procedure to persist those learnings as reusable skills or auto-applied instructions in the repository. ## Core Features & Use Cases - Decision Framework: Guides the choice between adding a short learning to an existing instruction, creating a standalone skill, or creating an auto-applied instruction with applyTo glob patterns. - Standardized File Creation: Enforces correct SKILL.md frontmatter conventions, including the rule that the name field must match the parent folder name, and supports both .github/skills/ and .agents/skills/ locations. - Quality Checks: Validates that each captured learning is general enough to help future sessions, specific enough to be actionable, and includes concrete right-vs-wrong examples. - Use Case: After spending an hour debugging a non-obvious build configuration issue, say "learn!" and the Skill will check existing instruction files, then create a new skill documenting the pitfall and its fix so future sessions avoid the same trap. ## Quick Start Tell the agent "learn!" after discovering a significant pattern or pitfall, and it will capture the insight as a skill or instruction file in the repository.

Frequently Asked Questions about update-skills

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

FAQPage Schema
How do I make an AI agent remember learnings across sessions?▼

Use this Skill by saying "learn!" after a significant discovery. It captures the insight as a SKILL.md file or instruction file in the repository, so future sessions load the knowledge automatically or invoke it by name.

When should I create a skill versus an instruction file?▼

Create a skill when the knowledge is substantial, covers a distinct domain, and should be invoked on demand. Create an instruction when the rule should apply automatically based on file patterns via the applyTo field, such as coding conventions or architectural constraints.

Where are skill files stored in a repository?▼

Project-level skills go in .github/skills/{name}/SKILL.md and are committed to the repo. Agent-specific skills go in .agents/skills/{name}/SKILL.md. The name field in the frontmatter must exactly match the parent folder name.

What makes a captured learning high quality?▼

A good learning is general enough to help future sessions, specific enough to be actionable, and includes a concrete example of right versus wrong. It should avoid duplicating knowledge already captured in existing skills or instructions.

Can I add a small learning without creating a new file?▼

Yes. Small insights of one to four sentences that fit an existing guideline should be appended to the Learnings section of an existing instruction file, following the pattern in .github/instructions/learnings.instructions.md.