Skip to content

Repository files navigation

SkillAlchemy

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

English · 中文

arXiv Stars License Supported agents

📄 Paper  ·  📑 PDF  ·  📚 Documentation

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 Setting Claude Code
DeepSeek-V4-Pro
Claude Code
Opus 4.8
Codex
DeepSeek-V4-Pro
Codex
GPT-5.5
Avg.
No Skill 23.4 45.3 29.7 45.1 35.9
Anthropic Skill-Creator 31.7 49.2 32.9 48.5 40.6
OpenAI Skill-Creator 33.3 49.9 37.0 48.5 42.2
OpenSkill 42.3 51.5 40.7 49.4 46.0
MUSE-Autoskill 43.2 53.3 40.2 52.0 47.2
Human-Curated Skill 51.3 59.5 45.7 60.9 54.4
SkillAlchemy 54.7 60.9 43.9 63.7 55.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

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

Citation

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.


Paper · Documentation · MIT License