Sandbox
@agentsope/SkillAlchemy

Skill creation system for Claude Code and Codex

SkillAlchemy turns a brief and open-world evidence into an installable skill. It discovers missing requirements, pulls procedures from sources like docs and papers, decides what is reusable, and writes the admitted knowledge into skill packages. The repo also ships a library of example skills under `skills/`, so builders can install the system or pick up individual skill packs.

394 stars21 forksPythonUpdated 15d ago
Who it's for

Builders who want Claude Code or Codex to turn source material into reusable skills.

What it delivers

You can create installable skills from messy briefs and public evidence instead of writing each one by hand.

What it does

Discover implicit requirements

Recovers constraints and behavior details missing from the original skill brief.

Distill people and methods

Turns public evidence about people, workflows, books, repositories, and papers into executable skills.

Admit evidence-supported procedures

Separates reusable instructions from one-off examples and unsupported claims.

Fuse existing skills

Combines workflows, domain knowledge, or working styles into a new skill.

Compile installable skill packages

Packages procedures, examples, references, and resources into skills agents can load and use.

How to get it

  1. 1The easiest way to install SkillAlchemy is to ask Claude Code or Codex
    Install SkillAlchemy from https://github.com/agentsope/SkillAlchemy and show me how to use it.
  2. 2Or use the command line
    npx skills add agentsope/SkillAlchemy
  3. 3Then describe the Skill you want to create
    Use SkillAlchemy to create a Skill for reviewing RAG systems.
    Use public documentation and research papers as sources.
  4. 4Run
    # Core components
    npx skills add agentsope/SkillAlchemy/skills/Lens
    npx skills add agentsope/SkillAlchemy/skills/LEAP
    
    # Another bundled Skill
    npx skills add agentsope/SkillAlchemy/skills/<skill-name>

README

SkillAlchemy

Turn people, methods, and experience into installable, reusable agent skills.

English · 中文 · 日本語

arXiv Stars Supported agents

SkillAlchemy is an open-world agent skill creation system that turns underspecified skill briefs and open-world sources into installable, reusable agent skills.

It discovers omitted requirements, identifies executable procedures from heterogeneous public sources, determines how broadly each procedure is justified by evidence, and compiles the admitted knowledge into agent skill packages.

SkillAlchemy framework

🔥 News

Overview

Creating reliable agent skills is difficult when the target capability is unfamiliar: task descriptions omit important requirements, expert-written procedures may not exist, and execution traces may be unavailable.

SkillAlchemy approaches skill creation as a source-grounded procedure-admission problem.

Given an underspecified skill brief and access to open-world sources, it:

  1. Discovers implicit requirements that are missing from the original brief.
  2. Acquires grounded procedures from documentation, repositories, papers, issue reports, and other public sources.
  3. Determines procedure scope — deciding whether evidence supports a reusable instruction, a scoped example, or exclusion.
  4. Compiles an installable Skill package that agents can load and use directly.

Results

We evaluate SkillAlchemy on 87 tasks from SkillsBench v1.1 across four agent–model configurations.

SkillAlchemy achieves the highest overall task pass rate in 3 of 4 configurations.

Averaged across all configurations, SkillAlchemy reaches a 55.8% task pass rate:

  • +19.9 percentage points over no-skill execution.
  • +8.6 percentage points over the strongest automated skill-creation baseline.
  • Performance comparable to human-curated skills, slightly exceeding them on average in our evaluation.
Skill SettingClaude Code
DeepSeek-V4-Pro
Claude Code
Opus 4.8
Codex
DeepSeek-V4-Pro
Codex
GPT-5.5
Avg.
No Skill23.445.329.745.135.9
Anthropic Skill-Creator31.749.232.948.540.6
OpenAI Skill-Creator33.349.937.048.542.2
OpenSkill42.351.540.749.446.0
MUSE-Autoskill43.253.340.252.047.2
Human-Curated Skill51.359.545.760.954.4
SkillAlchemy54.760.943.963.755.8

Features

  • Discover implicit requirements — Recover behavior-relevant requirements, constraints, and operational dimensions omitted by an underspecified Skill brief.
  • Distill people — Build Persona Skills from public evidence about decisions, failures, values, and communication patterns.
  • Distill methods — Turn books, methodologies, repositories, documentation, papers, or interviews into executable Skills with conditions, steps, branches, and failure handling.
  • Admit evidence-supported procedures — Separate reusable instructions from context-specific examples and unsupported content instead of treating every retrieved finding as universally valid.
  • Fuse Skills — Combine existing workflows, domain knowledge, or working styles into a new capability.
  • Compile installable Skills — Package admitted procedures, examples, references, and supporting resources into Skills that agents can load and use directly.

Quick Start

The easiest way to install SkillAlchemy is to ask Claude Code or Codex:

Install SkillAlchemy from https://github.com/agentsope/SkillAlchemy and show me how to use it.

Or use the command line:

npx skills add agentsope/SkillAlchemy

Then describe the Skill you want to create:

Use SkillAlchemy to create a Skill for reviewing RAG systems.
Use public documentation and research papers as sources.

Generated packages are written to output/ in the active project.

Install Individual Skills

# Core components
npx skills add agentsope/SkillAlchemy/skills/Lens
npx skills add agentsope/SkillAlchemy/skills/LEAP

# Another bundled Skill
npx skills add agentsope/SkillAlchemy/skills/<skill-name>

Browse all installable Skills

Paper & Citation

For the full formulation, framework design, and experimental evaluation, see:

SkillAlchemy: Open-World Agent Skill Creation Hengjun Wang, Shuyue Wei, Boyi Liu, Jun Yang, Yongxin Tong. arXiv:2608.23417, 2026 arXiv · PDF

If you find SkillAlchemy useful in your research or work, please cite our paper:

@article{wang2026skillalchemy,
  title   = {SkillAlchemy: Open-World Agent Skill Creation},
  author  = {Wang, Hengjun and Wei, Shuyue and Liu, Boyi and Yang, Jun and Tong, Yongxin},
  journal = {arXiv preprint arXiv:2608.23417},
  year    = {2026}
}

License

SkillAlchemy is released under the MIT License.


Technical Documentation

Files in the repo

Repository payload16 top-level entries
  • assets
  • skills
  • .editorconfig
  • .gitignore
  • CHANGELOG.md
  • CONTRIBUTING.md
  • LICENSE
  • package.json
  • README_CN.md
  • README_JA.md
  • README.md
  • skill.json
  • SKILL.md
  • SkillAlchemy-flow-brief.png
  • SkillAlchemy.gif
  • TECHNICAL.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 harnesses

affaan-m/
ECC
affaan-m/ECCHarnesses

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

258k

The job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.

42k
ruvnet/rufloHarnesses

🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

72k

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

11k