Introduction (中文)

xmake-skills is a collection of Agent Skills for Xmake, the cross-platform build utility based on Lua. These skills give AI coding assistants (such as Claude Code) the knowledge they need to create, configure, build, debug, and package Xmake projects correctly.

Each skill packages up focused Xmake know-how — from writing xmake.lua to integrating C/C++ packages — so AI agents can produce idiomatic, working Xmake configurations instead of guessing.

See skills/ for the full list and layout.

Context cost: The 53 skill trigger descriptions (frontmatter description fields) consume about 4k tokens in total. These are always loaded so the agent knows which skills are available. The full skill body is only loaded on demand when the task matches the description — so you get comprehensive Xmake coverage without wasting context.

Why

Large language models often know about Xmake but get the details wrong: outdated APIs, wrong option names, broken package syntax. Skills fix this by loading just the right documentation and examples into the agent's context when it is actually working on Xmake.

Usage

Claude Code (recommended)

Install from GitHub:

claude plugins install xmake-io/xmake-skills

Or add as a marketplace first, then install:

# In Claude Code interactive session:
/plugin marketplace add xmake-io/xmake-skills
/plugin install xmake-skills

Manual installation

Clone this repository and point your agent at it directly. Refer to your agent platform's documentation for how to install and enable skills.

git clone https://github.com/xmake-io/xmake-skills.git

DeepSeek Harness (DSH)

This repository is also an installable DeepSeek Harness bundle — it registers every skill in skills/ as an on-demand agent skill accessible in any DSH session. The harness config is kept together under .dsh-plugin/ (index.js, cordis.patch.yml, and the SKILL.md navigation index), with package.json at the root pointing main and dsh.bundle.patch into it. The entry point is plain ESM JS, so no build step is required.

# Local — run from the directory that contains this repo (e.g. H:\dsh_space\),
# so ./xmake-skills resolves to this bundle's folder:
dsh plugin --profile web add ./xmake-skills

# From GitHub (pin a commit for reproducibility):
dsh plugin --profile web add https://github.com/xmake-io/xmake-skills.git

# Alternatives (shorthand / packed tarball):
#   dsh plugin --profile web add github:xmake-io/xmake-skills#<sha>
#   pnpm pack && dsh plugin --profile web add ./xmake-skills-<version>.tgz

To uninstall (removes both the dependency and the bundle layer):

dsh plugin --profile web remove xmake-skills

Contributing

Contributions are very welcome. If you want to add a new skill or improve an existing one, please open an issue or pull request.

Resources

• Xmake: https://github.com/xmake-io/xmake
• Documentation: https://xmake.io
• Community: https://discord.gg/xmake

License

Licensed under the Apache License, Version 2.0. See LICENSE.md for details.