# asm-build

asm-build is a Claude Code skill for building, testing, and improving assembly software. It activates around target-specific code, package reuse, and measured optimization.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 560 repo stars
- Author: stubbi
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/stubbi/asm/tree/HEAD/skills/asm-build/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/asm-build

## What it does

asm-build guides assembly work through the Asm package registry and command-line tool. It separates the ISA, operating system, ABI, minimum OS, and CPU features for a target, then helps select an exact package release and artifact. Native projects use `asm build`, `asm test`, and `asm run`; a foreign test can be built with `asm test --target TARGET --no-run`.

The Asm MCP adapter is read-only. It can inspect targets and packages or compare supplied measurements, but it does not build, execute, install, publish, or certify results. Local assembly builds can read included files, so they are not isolated security boundaries. Native CLI work needs a supported host and the required Asm tools, with `asm doctor` run before build commands. Cross-assembly requires the fixed GNU or LLVM tools described by the project contract.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add stubbi/asm --skill asm-build -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/asm-build/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/asm-build/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add stubbi/asm --skill asm-build -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/asm-build/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add stubbi/asm --skill asm-build -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/asm-build/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install stubbi/asm skills/asm-build
```

2. **Manually: put the files in place**
- File: `.github/skills/asm-build/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add stubbi/asm --skill asm-build -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/stubbi/asm --path skills/asm-build
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/asm-build/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/stubbi/asm/tree/HEAD/skills/asm-build/SKILL.md

## When to use it
- build and test an assembly project for an explicit target
- separate ISA, ABI, OS, and CPU-feature requirements
- inspect a compatible package release and its ABI constraints
- compare optimization candidates by time, memory, and executable size
- compile a foreign target's tests without running them locally

## Example prompts
- Build the native assembly project with `asm build`, then run its tests.
- Find a package compatible with this ISA and inspect the exact release before choosing it.
- Compile tests for `TARGET` without execution using `asm test --target TARGET --no-run`.

## Similar
- [lean-build](https://affpapa.org/en/nevibecode/skills/lean-build.md) — skill · 128500 installs
- [firecrawl-build-scrape](https://affpapa.org/en/nevibecode/skills/firecrawl-build-scrape.md) — skill · 63000 installs
- [firecrawl-build-search](https://affpapa.org/en/nevibecode/skills/firecrawl-build-search.md) — skill · 62900 installs
- [flutter-build-responsive-layout](https://affpapa.org/en/nevibecode/skills/flutter-build-responsive-layout.md) — skill · 46800 installs
- [dart-build-cli-app](https://affpapa.org/en/nevibecode/skills/dart-build-cli-app.md) — skill · 20000 installs
- [bmad-build](https://affpapa.org/en/nevibecode/skills/bmad-build.md) — skill · 18600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
