The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
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.
Builders who want Claude Code or Codex to turn source material into reusable skills.
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
- 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.
- 2Or use the command line
npx skills add agentsope/SkillAlchemy
- 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.
- 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.
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.
🔥 News
- 2026-08-24 — Our paper, SkillAlchemy: Open-World Agent Skill Creation, is now available on arXiv.
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:
- Discovers implicit requirements that are missing from the original brief.
- Acquires grounded procedures from documentation, repositories, papers, issue reports, and other public sources.
- Determines procedure scope — deciding whether evidence supports a reusable instruction, a scoped example, or exclusion.
- 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>
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.
Files in the repo
- 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 itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More harnesses
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.
from vibe coding to agentic engineering - practice makes claude perfect
🌊 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
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.
Git. Ship. Done - Core