Agent skill

Compiler

How the atopile compiler builds and links TypeGraphs from .ato (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints.

MITAuto-check passedFrontend & Design

Install Compiler

skills CLI

$ npx skills add atopile/atopile --skill compiler -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install atopile/atopile compiler --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/atopile/atopile.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/compiler .claude/skills/compiler && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "compiler" agent skill from https://github.com/atopile/atopile/tree/main/.claude/skills/compiler into .claude/skills/compiler/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compiler", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/atopile/atopile/tree/main/.claude/skills/compiler

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add atopile/atopile --skill compiler -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install atopile/atopile compiler --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/atopile/atopile.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/compiler .agents/skills/compiler && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "compiler" agent skill from https://github.com/atopile/atopile/tree/main/.claude/skills/compiler into .agents/skills/compiler/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compiler", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add atopile/atopile --skill compiler -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install atopile/atopile compiler --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/atopile/atopile.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/compiler .cursor/skills/compiler && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "compiler" agent skill from https://github.com/atopile/atopile/tree/main/.claude/skills/compiler into .cursor/skills/compiler/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compiler", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/atopile/atopile.git --path .claude/skills/compiler

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add atopile/atopile --skill compiler -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install atopile/atopile compiler --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/atopile/atopile.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/compiler .gemini/skills/compiler && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "compiler" agent skill from https://github.com/atopile/atopile/tree/main/.claude/skills/compiler into .gemini/skills/compiler/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compiler", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install atopile/atopile compiler

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add atopile/atopile --skill compiler -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/atopile/atopile.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/compiler .github/skills/compiler && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "compiler" agent skill from https://github.com/atopile/atopile/tree/main/.claude/skills/compiler into .github/skills/compiler/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compiler", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add atopile/atopile --skill compiler -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install atopile/atopile compiler --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/atopile/atopile.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/compiler .opencode/skills/compiler && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "compiler" agent skill from https://github.com/atopile/atopile/tree/main/.claude/skills/compiler into .opencode/skills/compiler/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compiler", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: compiler
GitHub stars: 4k
Token cost: ~1k tokens
SKILL.md length: 286 words
Files: 1
Skills in repo: 19
Repo updated: Jun 13, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

How the atopile compiler builds and links TypeGraphs from .ato (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints.

Works in 3 steps: Grammar changes → Language features → Linking/terminal behavior
Modifying the compiler pipeline
SKILL.md covers Quick Start, Relevant Files, Dependants (Call Sites) and How to Work With / Develop /…, plus 1 more section
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Compiler is an agent skill from atopile/atopile. How the atopile compiler builds and links TypeGraphs from .ato (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints. Use when modifying the compiler pipeline, grammar, AST visitors, or type resolution.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design. The repository describes itself as: Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️. The licence is MIT.

When your agent uses it

Modifying the compiler pipeline
Type resolution

Example prompts

“/compiler”

Requirements

Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Grammar changes
Language features
Linking/terminal behavior

What it can do on your machine

Read from SKILL.md and the folder at commit 619eda7. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are python).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Compiler loads about 1k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 286 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~67
When it runs · the whole SKILL.md, loaded when a task matches: ~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from atopile/atopile at commit 619eda7, republished under its MIT licence (© atopile). 286 words, ~1,021 tokens.

Download SKILL.mdSave it as .claude/skills/compiler/SKILL.md (or your agent's skills folder).

name: compiler
description: How the atopile compiler builds and links TypeGraphs from `.ato` (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints. Use when modifying the compiler pipeline, grammar, AST visitors, or type resolution.

Compiler Module

The compiler builds a linked, self-contained TypeGraph from .ato sources. Export/manufacturing artifacts are handled later by build steps/exporters; the compiler’s job is parsing + typegraph construction + linking.

Start with:

src/atopile/compiler/README.md (stage overview + example usage)
src/atopile/compiler/parser/README.md (how to regenerate ANTLR output)

Quick Start

Build a single .ato file into a linked TypeGraph (and instantiate its entrypoint):

python

import faebryk.core.faebrykpy as fbrk
import faebryk.core.graph as graph
import faebryk.core.node as fabll
from atopile.compiler.build import Linker, StdlibRegistry, build_file
from atopile.compiler.deferred_executor import DeferredExecutor
from atopile.config import config

g = graph.GraphView.create()
tg = fbrk.TypeGraph.create(g=g)
stdlib = StdlibRegistry(tg)
linker = Linker(config, stdlib, tg)

result = build_file(g=g, tg=tg, import_path="app.ato", path="path/to/app.ato")
linker.link_imports(g=g, state=result.state)
DeferredExecutor(g=g, tg=tg, state=result.state, visitor=result.visitor).execute()

app_type = result.state.type_roots["ENTRYPOINT"]
app_root = tg.instantiate_node(type_node=app_type, attributes={})
app = fabll.Node.bind_instance(app_root)

Relevant Files

Core pipeline:
- src/atopile/compiler/build.py (build_file, build_source, Linker, StdlibRegistry, stage helpers)
- src/atopile/compiler/parse.py (ANTLR parse + error listener → UserSyntaxError)
- src/atopile/compiler/antlr_visitor.py (ANTLR CST → internal AST graph with source info)
- src/atopile/compiler/ast_visitor.py (AST → TypeGraph “preliminary” construction)
- src/atopile/compiler/gentypegraph.py (typegraph generation utilities + import refs)
- src/atopile/compiler/deferred_executor.py (terminal stage: inheritance/retypes/for-loops)
Parser frontend:
- src/atopile/compiler/parser/ (AtoLexer.g4, AtoParser.g4, generated Python)

Dependants (Call Sites)

CLI (src/atopile/cli/build.py): Calls the compiler to build the project.
LSP (src/atopile/lsp/lsp_server.py): Builds per-document graphs and keeps the last successful result for completions/hover.

How to Work With / Develop / Test

Core Concepts

ANTLR front-end: parse .ato into an ANTLR parse tree; syntax errors are converted to UserSyntaxError.
AST graph: ANTLRVisitor converts ANTLR output into internal AST nodes (FabLL nodes with source info).
TypeGraph build: AST visitor emits a preliminary TypeGraph.
Linking: Linker resolves imports, executes inheritance ordering, applies retypes, and prepares a self-contained compilation unit.
Deferred execution (terminal): DeferredExecutor.execute() runs operations that require resolved types (inheritance, retypes, for-loops).

Development Workflow

Grammar changes:
- edit src/atopile/compiler/parser/AtoLexer.g4 / AtoParser.g4
- regenerate (see src/atopile/compiler/parser/README.md)
Language features:
- CST → AST: src/atopile/compiler/antlr_visitor.py
- AST → TypeGraph: src/atopile/compiler/ast_visitor.py / gentypegraph.py
Linking/terminal behavior:
- src/atopile/compiler/build.py / src/atopile/compiler/deferred_executor.py

Testing

Compiler tests: ato dev test --llm test/compiler -q
Linker behavior: ato dev test --llm test/compiler/test_linker.py -q
End-to-end smoke: ato dev test --llm test/test_end_to_end.py -q

Best Practices

Keep errors source-attached: raise DslRichException/UserException with AST source info when possible.
Watch graph lifetimes: most entrypoints accept (g, tg) explicitly; ensure you destroy GraphView in long-running processes (LSP does this).

Files

Just SKILL.md in .claude/skills/compiler of atopile/atopile.

Open the folder on GitHubat commit 619eda7

Compare with similar skills

Compiler next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Compiler compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Compiler this skillatopile/atopile	4k	—	~1k	Automated safety check: Pass	MIT	3 mo ago
Web Artifacts Builderanthropics/skills	180k	40 repos	~769	Automated safety check: Pass	Apache-2.0	2 days ago
React Doctormakeplane/plane	60k	12 repos	~657	Automated safety check: Pass	AGPL-3.0	yesterday
React Composition Patternsvercel-labs/openreview	1.7k	58 repos	~721	Automated safety check: Pass	MIT	7 mo ago
Impeccablebestofjs/bestofjs	3.1k	27 repos	~2.6k	Automated safety check: Pass	MIT	3 days ago
Figma Design System Builderwarpdotdev/warp	65k	2 repos	~4.4k	Automated safety check: Pass	AGPL-3.0	yesterday

Similar skills

Web Artifacts Builder
anthropics/skills
Official
Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.
180k GitHub starsUsed in 40 repos~769 tokens
Frontend & DesignAuto-check passed
React Doctor
makeplane/plane
Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.
60k GitHub starsUsed in 12 repos~657 tokens
Frontend & DesignAuto-check passed
React Composition Patterns
vercel-labs/openreview
Official
Rules for structuring React components with composition instead of boolean props, covering compound components, lifted state, variants and React 19 changes.
1.7k GitHub starsUsed in 58 repos~721 tokens
Frontend & DesignAuto-check passed
Impeccable
bestofjs/bestofjs
A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…
3.1k GitHub starsUsed in 27 repos~2.6k tokens
Frontend & DesignAuto-check passed
Figma Design System Builder
warpdotdev/warp
Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.
65k GitHub starsUsed in 2 repos~4.4k tokens
Frontend & DesignAuto-check passed
Tailwindcss Development
anonaddy/anonaddy
Always invoke when the user's message includes 'tailwind' in any form.
4.9k GitHub starsUsed in 10 repos~865 tokens
Frontend & DesignAuto-check passed

Questions about Compiler

What does Compiler do?

How the atopile compiler builds and links TypeGraphs from .ato (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints. Compiler is an agent skill from atopile/atopile.ato (ANTLR front-end → AST → TypeGraph → Linker → DeferredExecutor), plus the key invariants and test entrypoints.

When should I use Compiler?

Compiler fits situations like: modifying the compiler pipeline; type resolution.

How do I install Compiler in Claude Code?

Run `npx skills add atopile/atopile --skill compiler -a claude-code`. Or copy the skill folder (.claude/skills/compiler in atopile/atopile) into .claude/skills/compiler in your project. Claude Code loads it when a task matches its description.

How do I install Compiler in Codex?

Run `npx skills add atopile/atopile --skill compiler -a codex`. Or copy the skill folder (.claude/skills/compiler in atopile/atopile) into .agents/skills/compiler in your project. Codex loads it when a task matches its description.

Can I use Compiler in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add atopile/atopile --skill compiler -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compiler, .gemini/skills/compiler, .github/skills/compiler and .opencode/skills/compiler in your project.

What does Compiler need to run?

SKILL.md names no scripts, command-line tools or credentials: Compiler is instructions for the agent only. Our summary lists: Python 3.

Does Compiler access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Compiler safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Compiler use?

Compiler is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Compiler use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Compiler?

Skills that share tags, products or a category with Compiler: Web Artifacts Builder (anthropics/skills, 180k stars), React Doctor (makeplane/plane, 60k stars), React Composition Patterns (vercel-labs/openreview, 1.7k stars) and Impeccable (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Compiler?

atopile (a GitHub organization) maintains it in atopile/atopile, which has 3,973 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on June 13, 2026.

Source: atopile/atopile on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Compiler

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Compiler Module

Quick Start

Relevant Files

Dependants (Call Sites)

How to Work With / Develop / Test

Core Concepts

Development Workflow

Testing

Best Practices

Files

Compare with similar skills

Similar skills

More from atopile/atopile

Related

Questions about Compiler