Repolode
Submit
tigerless-labs

tigerless-labs/autoharness

A self-learning skill layer for Claude Code that distills skills from real sessions, merges and updates them in use, and prunes the ones that stop being used.

View on GitHubWebsite
Stars
10,743
Forks
653
Open issues
55
Last commit
2 days ago

What is it?

autoharness is a plugin for Claude Code that learns reusable skills from the sessions you are already running. Each episode is distilled into a native SKILL.md file under .claude/skills/, and a reflector compares new lessons against the existing library so that same-scenario skills are merged rather than piling up as near-duplicates.

The lifecycle is driven by use rather than a benchmark. A skill's survival depends on how often later turns actually load it, and skills that go unused are archived instead of deleted. The plugin only touches skills it generated itself, marked with a ledger, and leaves hand-written or installed skills alone. Each create or update is logged with its reason and evidence in a per-skill ledger.

It runs without a resident daemon. Learning is triggered by tool-call counts within a session, and the library is recalled through a grouped index injected at session start. Requires Python 3.11+ on the PATH, with no third-party dependencies.

Key features

  • 01Distills skills from real Claude Code sessions automatically, with /learn for on-demand capture.
  • 02Merges same-scenario skills into one instead of creating near-duplicates.
  • 03Tracks skill usage and archives unused skills rather than deleting them.
  • 04Only modifies skills it generated, identified by a ledger marker.
  • 05Logs every create or update with reason and evidence for later review.
  • 06Runs without a daemon and injects a grouped skill index at session start.

Use cases

  • Keeping a project's Claude Code skill library current as workflows and debugging lessons accumulate.
  • Capturing repeated fixes or command sequences from daily coding sessions without writing skills by hand.
  • Running a self-maintaining skill layer where stale skills are pruned automatically.

Quick start

  1. 1

    Make sure Python 3.11+ is the python3 on your PATH

  2. 2

    Add the marketplace in Claude Code

    /plugin marketplace add tigerless-labs/autoharness
  3. 3

    Install the plugin in Claude Code

    /plugin install autoharness@autoharness
  4. 4

    Reload plugins (or restart Claude Code)

    /reload-plugins

Things to know

  • Supported only on Linux and macOS.
  • Requires Python 3.11+ as python3 on PATH; an older default interpreter silently disables its hooks.
  • It automatically writes and prunes skills in .claude/skills/ in the background.

In collections

Claude Code tools, skills & pluginsAI coding assistants & agentsAI agent skill libraries

Topics

#claude-code#agent-skills#llm-agents#claude-code-plugin#self-learning#ai-coding#python

FAQ

What is autoharness?
A self-learning skill layer for Claude Code that distills skills from real sessions, merges and updates them in use, and prunes the ones that stop being used. autoharness is a plugin for Claude Code that learns reusable skills from the sessions you are already running. Each episode is distilled into a native SKILL.md file under .claude/skills/, and a reflector compares new lessons against the existing library so that same-scenario skills are merged rather than piling up as near-duplicates.
Is autoharness free to use? What license does it have?
autoharness is open source under the MIT license. Check the license terms before using it in commercial products.
Is autoharness still maintained?
Actively maintained. The last commit to autoharness was on Nov 4, 2026.
What can I use autoharness for?
Keeping a project's Claude Code skill library current as workflows and debugging lessons accumulate. Capturing repeated fixes or command sequences from daily coding sessions without writing skills by hand. Running a self-maintaining skill layer where stale skills are pruned automatically.
How do I install autoharness?
Make sure Python 3.11+ is the python3 on your PATH Add the marketplace in Claude Code: /plugin marketplace add tigerless-labs/autoharness Install the plugin in Claude Code: /plugin install autoharness@autoharness Reload plugins (or restart Claude Code): /reload-plugins
Where can I get autoharness?
The source code and installation instructions are on GitHub: https://github.com/tigerless-labs/autoharness

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects