gitmyhub

SkillAlchemy

Python ★ 219 updated 27d ago

From thought to skill. From signal to structure.

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.

PythonClaude CodeCodexnpxsetup: easycomplexity 2/5

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.

Where it fits