OlegVG Skills

Русская версия

A grouped personal skill repository for Claude Code, Codex, and agents supported by the Vercel Skills CLI. It ships two installable root-skill groups: kb-for-agents for the three-layer knowledge base pattern described in Knowledge Base for Agents and core-dev for portable development workflows, plus the standalone transcribing-audio plugin for Claude Code and Codex.

What's inside

• kb-for-agents group — kb-build, kb-query, kb-check-drift, kb-refresh, kb-record-decision, kb-maintain.
• core-dev group — simplify-code, a portable behavior-preserving cleanup skill adapted from Claude Code's /simplify workflow.
• olegvg-skills umbrella — all root-skill groups in this repository.
• transcribing-audio plugin (Claude Code and Codex) — local or OpenAI ASR, speaker diarization, word timestamps, and resumable processing. It is installed separately because it includes its own Python runtime and dependencies.
• Claude Code commands — KB-only thin wrappers over the skills. Marketplace plugins namespace them, for example /kb-for-agents:kb-build; core-dev exposes no command shims. They are unavailable through npx skills add.
• Templates — starter shapes for indexes, summaries, decisions, _root.md, state. See templates/README.md for manual-build steps.
• Docs — pattern rationale: concept, navigation rules, refresh strategy.

Install

Any agent via npx skills add (Vercel Skills CLI)

The root runtime skills follow the agentskills.io spec and can be installed into Claude Code, Codex, Cursor, and other agents through the skills CLI. The interactive picker shows the concrete groups kb-for-agents and core-dev; select both groups to install every root skill. For non-interactive installs, use explicit --skill selections. The umbrella install is --skill '*' because the CLI currently assigns each skill to one visible group.

# List grouped skills in the repo
npx skills add olegvg/olegvg-skills --list

# Install the kb-for-agents group
npx skills add olegvg/olegvg-skills \
  --skill kb-build \
  --skill kb-query \
  --skill kb-refresh \
  --skill kb-check-drift \
  --skill kb-record-decision \
  --skill kb-maintain

# Install the core-dev group
npx skills add olegvg/olegvg-skills --skill simplify-code

# Install every root skill non-interactively
npx skills add olegvg/olegvg-skills --skill '*'

# Install core-dev into Codex globally
npx skills add olegvg/olegvg-skills --skill simplify-code -a codex -g -y

# Install across multiple agents at once
npx skills add olegvg/olegvg-skills -a claude-code -a codex -a cursor

This pathway installs root skills only, not Claude Code slash commands or standalone plugins. transcribing-audio also requires its bundled Python runtime, so install it through a plugin marketplace. Skills are still auto-invoked by trigger phrases — see each skill's description for the English and Russian phrases that activate it.

Claude Code plugin marketplace

/plugin marketplace add olegvg/olegvg-skills
/plugin install kb-for-agents@olegvg-skills
/plugin install core-dev@olegvg-skills
/plugin install olegvg-skills@olegvg-skills
/plugin install transcribing-audio@olegvg-skills

Use kb-for-agents when you want the KB command shims alongside the KB skills, core-dev for the portable cleanup skill, or olegvg-skills for every root skill in this repository. transcribing-audio is a standalone plugin that ships its own Python runtime, so install it separately with its own command above.

Run /reload-plugins after installing or updating a plugin. Claude Code namespaces its commands and skills: kb-for-agents provides /kb-for-agents:kb-build through /kb-for-agents:kb-maintain; olegvg-skills provides the same KB shims under /olegvg-skills:; core-dev deliberately has no command shim. Invoke audio transcription with /transcribing-audio:transcribing-audio or describe the task in natural language.

Unlike the Vercel Skills CLI picker, the Claude Code plugin marketplace has a real umbrella install target: olegvg-skills@olegvg-skills.

transcribing-audio in Claude Code

transcribing-audio is a standalone plugin outside the olegvg-skills umbrella, so install it on its own:

/plugin marketplace add olegvg/olegvg-skills
/plugin install transcribing-audio@olegvg-skills
/reload-plugins

Prerequisites (macOS or Linux; Windows is unsupported): Python 3.13, uv, ffmpeg, and ffprobe on PATH; local speaker diarization also needs approved Hugging Face access via HF_TOKEN. The plugin ships its own runtime — the first run probes the host and builds a cached plugin-local .venv, so the initial transcription is slower while dependencies resolve.

Then invoke it explicitly or describe the task in natural language:

/transcribing-audio:transcribing-audio /absolute/path/meeting.wav

Audio stays local by default; OpenAI ASR asks for explicit consent before any chunk leaves the machine.

Codex marketplace

This repository exposes two Codex plugins: the olegvg-skills umbrella at the repository root and the independent transcribing-audio plugin under plugins/transcribing-audio/.

• .codex-plugin/plugin.json and plugins/transcribing-audio/.codex-plugin/plugin.json describe the two plugin roots.
• .agents/plugins/marketplace.json indexes both plugins in the self-hosted Codex marketplace.

Use the Vercel Skills CLI with -a codex for a group-scoped root-skill install. To install one or both full plugins from the marketplace:

codex plugin marketplace add olegvg/olegvg-skills
codex plugin add olegvg-skills@olegvg-skills
codex plugin add transcribing-audio@olegvg-skills

transcribing-audio keeps its skill, runtime, and dependencies together in plugins/transcribing-audio/; it is not included in the umbrella plugin.

Start a new Codex session after installing or updating a plugin. Codex can select a matching skill automatically, or you can invoke one explicitly: $olegvg-skills:kb-build, $olegvg-skills:kb-query, $olegvg-skills:simplify-code, or $transcribing-audio:transcribing-audio. For OpenAI ASR, the audio skill asks for explicit consent before uploading audio.

Claude Desktop (individual skills)

Claude Desktop doesn't load Claude Code plugins, so runtime skills are published as individual zips on the Releases page. Download and upload the ones you need via the Claude Desktop skill UI:

• kb-build-<version>.zip
• kb-query-<version>.zip
• kb-refresh-<version>.zip
• kb-check-drift-<version>.zip
• simplify-code-<version>.zip

SHA256SUMS is attached to each release — verify with sha256sum -c SHA256SUMS.

kb-record-decision and kb-maintain are Claude Code–only: decision recording relies on the plan-document layout and orchestration. transcribing-audio is not published as a desktop zip either — its skill needs the bundled Python runtime, so install it via the Claude Code or Codex plugin marketplace.

Quickstart

After installing kb-for-agents in Claude Code and running /reload-plugins, use the KB command shims in a session opened at your corpus root:

/kb-for-agents:kb-build .
/kb-for-agents:kb-query where are fees charged?

After you've made changes to the corpus:

/kb-for-agents:kb-check-drift
/kb-for-agents:kb-refresh src/billing/

When a planned piece of work ships and you want its key choices preserved:

/kb-for-agents:kb-record-decision docs/plans/2026-03-19-1400/plan-billing-rewrite.md

After installing the Codex umbrella plugin, start a new session and use the equivalent skills:

$olegvg-skills:kb-build .
$olegvg-skills:kb-query where are fees charged?
$transcribing-audio:transcribing-audio /absolute/path/meeting.wav

How it works

The plugin builds a .kb/ directory inside your corpus (not inside the plugin). It has three layers plus a decisions store:

1. Sources — your corpus itself. Not duplicated.
2. Summaries (.kb/summaries/<area>/*.md) — prose per topic, one file each.
3. Indexes (.kb/indexes/*.md) — navigation, ≤300 tokens per file. Entry point is .kb/indexes/_root.md.

Alongside: Decisions (.kb/decisions/*.md) — distilled records extracted from completed plans. Each record names the summaries it affects in its own ## Affected areas block; summaries themselves are never edited when a decision is recorded. Agents find decisions for a summary by greping .kb/decisions/ for that summary's path; kb-query does this lookup automatically.

The agent reads indexes first on any query, then descends. If the question is "how does X work, and why was it built that way?", the navigation lands on a summary, and the decisions backreferenced from that summary surface in the same pass. Context stays bounded and the navigation path is reviewable.

See docs/concept.md for the full argument.

What this is

A starter kit: skills, commands, templates, conceptual docs. Patterns codified so you can apply them without re-reading the article.

What this is not

A RAG library or a general-purpose agent framework.

Requirements

• Claude Code or Codex with skills support.
• A corpus you want to document. A git-backed corpus is strongly recommended — /kb-refresh and /kb-check-drift both depend on git history.

License

MIT. See LICENSE.