gitwtfhub

wtf is skill-extractor?

surenode-ai/skill-extractor — explained in plain English

Analysis updated 2026-05-18

9PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A tool that mines your coding agent's session transcripts for repeated patterns and turns them into reviewable, editable skill files.

Mindmap

mindmap
  root((repo))
    What it does
      Mines patterns from transcripts
      Scores candidate skills
      Writes SKILL.md files
    Tech stack
      Python
      Claude Code
      Codex CLI
    Use cases
      Extract skills from Claude Code sessions
      Review candidates in VS Code
      Run local-only mining with ollama
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Mine reusable skills from your Claude Code or Codex session transcripts.

REASON 2

Review and approve or reject mined skills from a VS Code panel.

REASON 3

Redact secrets automatically before transcript excerpts reach a model.

REASON 4

Run mining entirely locally using an ollama backend for zero data egress.

What's in the stack?

PythonClaude CodeCodex CLIVS CodeOllama

How it stacks up

surenode-ai/skill-extractorabhinavshrivastava950/montaraalirezarezvani/promptor
Stars999
LanguagePythonPythonPython
Last pushed2025-09-14
MaintenanceQuiet
Setup difficultymoderatemoderateeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Sends transcript excerpts to a remote LLM by default, use the local command backend for zero external data transfer.

The README does not state a license in the shown excerpt.

Wtf does this do

skill-extractor scans through the transcripts of your coding agent sessions, tools like Claude Code or OpenAI Codex CLI, and pulls out reusable patterns it noticed you repeating: things like always running tests before saying a task is done, or avoiding a mistake that caused a previous session to fail. Instead of a general purpose memory feature that quietly changes an agent's behavior, this tool writes each discovered pattern out as a plain markdown skill file that you can read, edit, or delete yourself. The author built it after noticing they kept repeating the same corrections to their coding agent session after session, since those lessons were forgotten once each conversation ended. Every candidate skill it finds is scored by how useful and trustworthy it seems, weighted by whether the session it came from actually succeeded or failed, and only strong, new candidates are shown to you for review through a VS Code panel, a Claude Code slash command, or a plain command line tool. The project is explicit about its security tradeoffs. It runs on your own machine and reads private transcripts that may contain code, infrastructure details, and occasionally secrets, redacting common secret patterns like API keys and tokens before sending anything to a language model. By default it uses your existing Claude subscription to do the mining, but it can be pointed at a fully local model instead for zero external data transfer. Every skill it wants to install also runs through a safety check looking for risky instructions, and you must explicitly approve any flagged skill before it takes effect. It supports multiple agent sources sharing one review queue, six categories of skills such as workflows and guardrails, and is designed to make no model calls at all when there is nothing new to mine, keeping ongoing cost low. The full README is longer than what was shown.

Yoink these prompts

Prompt 1
Help me install and run surenode-ai/skill-extractor on my machine.
Prompt 2
Explain how skill-extractor scores candidate skills using outcome weighting.
Prompt 3
Walk me through configuring skill-extractor to use a local ollama model instead of Claude.
Prompt 4
Show me how the risk lint on installed skills works and how to acknowledge it.

Frequently asked questions

wtf is skill-extractor?

A tool that mines your coding agent's session transcripts for repeated patterns and turns them into reviewable, editable skill files.

What language is skill-extractor written in?

Mainly Python. The stack also includes Python, Claude Code, Codex CLI.

What license does skill-extractor use?

The README does not state a license in the shown excerpt.

How hard is skill-extractor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is skill-extractor for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.