explaingit

agentsope/skillalchemy

19PythonAudience · vibe coderComplexity · 2/5ActiveLicenseSetup · easy

TLDR

Chinese-language toolkit that turns a person, a methodology, or a body of experience into a structured Skill bundle that AI coding agents like Claude Code or Codex can load and follow.

Mindmap

mindmap
  root((SkillAlchemy))
    Inputs
      Person name
      Book or method
      Existing skill files
    Outputs
      Persona skill
      Methodology SOP
      Fused skill
    Use Cases
      Distil a thinker
      Package a framework
      Combine two skills
    Tech Stack
      Python
      Claude Code
      Codex
      npx skills CLI

Things people build with this

USE CASE 1

Distil a public figure into a persona Skill you can chat with inside Claude Code

USE CASE 2

Convert a book or framework into a runnable SOP with steps and failure handling

USE CASE 3

Fuse two existing skills into one combined ability for deeper analysis

USE CASE 4

Install ready-made skills from the skills/ folder by name

Tech stack

PythonClaude CodeCodexnpx

Getting it running

Difficulty · easy Time to first run · 30min

Needs Claude Code or Codex installed and the npx skills CLI; deep runs take 25 to 35 minutes per skill.

MIT license, so you can use, modify, and ship it commercially as long as you keep the copyright notice.

In plain English

SkillAlchemy is a Chinese-language project that turns a person, a method, or a body of experience into what it calls a Skill, which is a structured bundle of instructions that an AI coding agent such as Claude Code or Codex can load and follow. The tagline, roughly translated, is that a single thought, once grounded, can take on many shapes. Getting started is described in two ways. The first is to paste a single sentence into Claude Code or Codex asking it to fetch SkillAlchemy from this GitHub repo and install it into the local skills directory; the agent then handles the rest. The second is a command-line install via npx skills add agentsope/SkillAlchemy. Once installed, you can run prompts like distil Zhang Xuefeng at depth standard, blending first-principles thinking and the Feynman learning method, and the system will produce a callable Skill. The README says SkillAlchemy can do three kinds of distillation. It can distil a person, in which 4 to 5 research agents work in parallel to pull out decision moments, failure handling, value conflicts and expressive style from public material and compile a Persona Skill. It can distil a methodology, taking a book, a framework, a repo or an interview and turning it into a runnable standard operating procedure with preconditions, steps, branches and failure handling, each with checkable evidence. It can also fuse two existing skills into a new combined ability. There is a single tunable parameter called depth, with three values. Quick runs at most three research agents and takes around five to eight minutes, standard uses four or five and takes around fifteen to twenty minutes, and deep uses six to eight with double-checked validation and takes around twenty-five to thirty-five minutes. The pipeline has two confirmation pauses, which can be skipped with a default-everything setting. A skills/ folder in the repo already holds many pre-distilled Skills covering popular AI agent frameworks, tools and workflows, installable individually by name. The README is honest about limits. It says the system is not suited to people with little public material, to inventing inner-life details that the sources never had, to high-stakes professional decisions, or to rewriting copyrighted material. SkillAlchemy is released under the MIT licence.

Copy-paste prompts

Prompt 1
Install SkillAlchemy into my Claude Code skills directory and show me how to run a quick distillation of Steve Jobs
Prompt 2
Use SkillAlchemy at depth standard to distil first-principles thinking into a reusable Skill and save it under output/
Prompt 3
Fuse the first-principles and Feynman skills from SkillAlchemy into a single deep-understanding Skill
Prompt 4
List every pre-built Skill under SkillAlchemy/skills/ and recommend three I should install for AI agent work
Prompt 5
Run SkillAlchemy at depth deep on the methodology in this PDF and produce a callable SOP skill
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.