Sandbox
@ECNU-ICALK/AutoSkill

Skill evolution framework for agent builders

AutoSkill extracts reusable skills from real interactions, documents, and archived trajectories, then stores them as versioned skill files. It also supports skill search, merging, updating, replay, and evaluation so the same capability can improve over time instead of being recreated from scratch.

581 stars55 forksPythonUpdated 4mo ago
Who it's for

Builders who want agent sessions, documents, and trajectories to become reusable skills.

What it delivers

You can turn past work into versioned skills your agent can reuse and refine later.

What it does

Core skill lifecycle

Extracts skills from interactions, merges them, and updates versions as new feedback arrives.

Local skill manager

Manages local Agent Skill files after sessions, including triage, similar-skill search, and discard, improve, merge, or create decisions.

Document-to-skill pipeline

`AutoSkill4Doc/` extracts reusable skills from papers, manuals, and other domain documents.

Trajectory integration

`AutoSkill4OpenClaw/` mirrors skills from OpenClaw trajectories and supports runtime integration.

Replay and promotion loop

`SkillEvo/` provides replay, evaluation, mutation, and promotion for iterative skill self-evolution.

Skill storage

`SkillBank/` holds local skill files, vectors, and session data for reuse and retrieval.

README

AutoSkill: Experience-Driven Lifelong Learning via Skill Self-Evolution

English | 中文

AutoSkill Logo

Maintained By ICALK arXiv 2603.01145 GitHub ECNU-ICALK/AutoSkill License MIT

AutoSkill is a practical implementation of Experience-driven Lifelong Learning (ELL). It learns from real interaction experience (dialogue + agents), automatically creates reusable Skills, and continuously evolves existing Skills through merge + version updates.

AutoSkill Framework

News

  • 2026-05-09: Added the installable AutoSkill Local Skill Manager (skills/autoskill) for maintaining local Agent Skill files after sessions, including reusable-experience triage, similar-skill search, and discard / improve / merge / create decisions.
  • 2026-03-23: SkillEvo 1.0 released (Enabling models to iteratively self-evolve Skills through replay, evaluation, mutation, and promotion).
  • 2026-03-13: AutoSkill4Doc 1.0 released (Being expext by extracting skills from document/research paper).
  • 2026-03-01: Added offline skill extraction from archived conversations (See Skills in SkillBank/CovSkill).
  • 2025-02-26: AutoSkill4OpenClaw 1.0 released (Extracting skills from trajectory of OpenClaw).
  • 2025-02-04: AutoSkill 1.0 released (Extracting skills from dialogues in time).

Table of Contents

1. Project Overview

  • Experience-driven continuous skill evolution: extracts reusable capabilities directly from real user interactions and agent traces, then continuously maintains versioned skills so the system aligns with user needs over time.
  • Universal skill format: uses the Agent Skill artifact (SKILL.md) with explainability and editability. Skills remain readable, reviewable, and manually revisable.
  • Offline extraction from completed data: existing chats and trajectories can be imported directly for offline skill extraction; there is no need to replay the original interaction.
  • Long-term capability value: AutoSkill turns short-term interaction signals into long-term capability assets that can be reused across runtimes.

2. Main Components

  • autoskill/: core SDK, Web UI, OpenAI-compatible proxy, online skill evolution, offline conversation extraction, and offline trajectory extraction.
  • AutoSkill4Doc/: standalone document-to-skill pipeline for extracting reusable skills from papers, manuals, and domain documents.
  • AutoSkill4OpenClaw/: OpenClaw integration for trajectory-driven skill evolution and native skill mirroring.
  • SkillEvo/: replay, evaluation, mutation, and promotion framework for iterative skill self-evolution.

3. Skill Lifecycle Example

A) Auto Decision + Feedback-triggered Extraction & Skill Management (v0.1.0)

If the user only asks to "write a report" and gives no stable preference/correction, AutoSkill does not create a new skill (it outputs an empty extraction result) to avoid noisy, generic skills.

When the user adds durable constraints (for example: "do not hallucinate"), AutoSkill extracts or merges a skill into version v0.1.0. Skill management is backend-first (automatic add/merge), with optional human edit/save/delete of SKILL.md.

Skill Extraction (Daily) Caption: Daily scenario — reusable writing constraints are extracted into a new skill (v0.1.0).

Skill Extraction (Science) Caption: Science scenario — reusable lab/process constraints (for example hard limits and mandatory SOP steps) are extracted as a skill (v0.1.0).

B) Skill Update (v0.1.1)

When user feedback adds new constraints or changes priorities in later turns, AutoSkill updates the existing skill (instead of creating duplicates) and evolves the version from v0.1.0 to v0.1.1.

Skill Update (Daily) Caption: Daily scenario — later user feedback updates constraints and evolves the skill to v0.1.1.

Skill Update (Science) Caption: Science scenario — follow-up technical feedback updates the existing science skill instead of creating duplicates (v0.1.1).

C) Skill Usage

For the next similar task (for example, writing a government report about a self-evolving agent), the updated skill is retrieved and used to generate outputs aligned with user expectations.

Skill Usage (Daily) Caption: Daily scenario — the evolved skill is retrieved and reused in the next similar task.

Skill Usage (Science) Caption: Science scenario — the evolved science skill is retrieved for subsequent domain-consistent requests.

4. Documentation Map

5. Repository Structure (Top Level)

  • autoskill/: core SDK and runtime.
  • AutoSkill4Doc/: standalone document-to-skill pipeline.
  • AutoSkill4OpenClaw/: OpenClaw integration.
  • SkillEvo/: iterative skill self-evolution framework.
  • examples/: runnable entrypoints and demos.
  • SkillBank/: default local skill storage root.
  • data/: evaluation and sample data.
  • tests/: automated tests.
  • web/: local Web UI assets.
  • imgs/: README figures and demo images.

6. Star History

Star History Chart

7. Citation

If you use AutoSkill in academic work, technical reports, or demos, please cite:

@software{autoskill_2026,
  author = {Yutao Yang, Junsong Li, Qianjun Pan, Bihao Zhan, Yuxuan Cai, Lin Du, Xin Li, Bo Zhang, Qin Chen, Jie Zhou, Kai Chen, Liang He},
  title = {AutoSkill: Experience-Driven Lifelong Learning via Skill Self-Evolution},
  year = {2026},
  url = {https://github.com/ECNU-ICALK/AutoSkill},
  note = {GitHub repository}
}

@misc{yang2026autoskillexperiencedrivenlifelonglearning,
  title={AutoSkill: Experience-Driven Lifelong Learning via Skill Self-Evolution},
  author={Yutao Yang and Junsong Li and Qianjun Pan and Bihao Zhan and Yuxuan Cai and Lin Du and Jie Zhou and Kai Chen and Qin Chen and Xin Li and Bo Zhang and Liang He},
  year={2026},
  eprint={2603.01145},
  archivePrefix={arXiv},
  primaryClass={cs.AI},
  url={https://arxiv.org/abs/2603.01145},
}

8. Contributions and Acknowledgments

Institutions: Shanghai AI Laboratory, School of Computer Science at East China Normal University

Core Authors: Yutao Yang

Contribution: Junsong Li, Qianjun Pan, Bihao Zhan, Yuxuan Cai, Lin Du

Lead Authors: Jie Zhou, Kai Chen, Liang He

Scientific Directors: Xin Li, Bo Zhang, Qin Chen

Files in the repo

Repository payload20 top-level entries
  • autoskill
  • AutoSkill4Doc
  • AutoSkill4OpenClaw
  • data
  • examples
  • imgs
  • SkillBank
  • SkillEvo
  • skills
  • tests
  • web
  • .dockerignore
  • .env.example
  • .gitignore
  • docker-compose.yml
  • Dockerfile
  • pyproject.toml
  • README.md
  • README.zh-CN.md
  • STATUS.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More frameworks & sdks

HKUDS/nanobotFrameworks & SDKs

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps

48k
microsoft/
SkillOpt
microsoft/SkillOptFrameworks & SDKs

SkillOpt is a text-space optimizer that trains reusable natural-language skills for frozen LLM agents through trajectory-driven edits, validation-gated updates, and deployable best_skill.md artifacts.

17k
omnigent-ai/omnigentFrameworks & SDKs

Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device.

9.8k
kyegomez/
OpenMythos
kyegomez/OpenMythosFrameworks & SDKs

A theoretical reconstruction of the Claude Mythos architecture, built from first principles using the available research literature.

15k
D4Vinci/ScraplingFrameworks & SDKs

🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

80k