---
name: AINL
slug: ainl
category: AI Engineering
description: AINL compiles deterministic `.ainl` graphs for ZeroClaw workflows. Use it to import, compile, run, and expose MCP tools for validation and orchestration.
github: "https://github.com/sbhooley/ainativelang/tree/main/skills/ainl"
language: Python
stars: 714
forks: 29
install: "npx degit https://github.com/sbhooley/ainativelang/tree/main/skills/ainl ~/.claude/skills/ainl"
installs_to: ~/.claude/skills/ainl
source_path: skills/ainl/SKILL.md
collection_size: 3
category_size: 2451
collection_url: "https://dirskills.com/collections/sbhooley/ainativelang"
added: 2026-08-23T05:20:19.720Z
last_synced: 2026-08-23T05:20:19.720Z
canonical_url: "https://dirskills.com/skills/ainl"
---

# AINL

AINL compiles deterministic `.ainl` graphs for ZeroClaw workflows. Use it to import, compile, run, and expose MCP tools for validation and orchestration.

**Install:**

```bash
npx degit https://github.com/sbhooley/ainativelang/tree/main/skills/ainl ~/.claude/skills/ainl
```

## README

# AINL for ZeroClaw

**AINL** is an AI-native language that compiles **deterministic graphs**. In ZeroClaw, use it to import workflows, compile them, run them, and expose **`ainl-mcp`** tools to the agent.

**Package:** `ainativelang` **v1.8.0** (this tree; **PyPI** after publish — **`docs/RELEASING.md`**). Optional extras: `[mcp]`, `[solana]`.

## Agent instructions

Follow this skill when the user is on **ZeroClaw** (or wants **deterministic `.ainl` graphs** with **import / compile / run / MCP**). Prefer **`./install.sh`** after `zeroclaw skills install …`, or the manual **`pip install 'ainativelang[mcp]' && ainl install-mcp --host zeroclaw`** path (alias **`ainl install-zeroclaw`**). After bootstrap, suggest the **morning briefing** prompt example below when it fits.

## When to use this skill

- The user wants **portable, compiled workflows** (`.ainl`) instead of ad-hoc prompts.
- They mention **import**, **compile**, **morning briefing**, **clawflows**, **ecosystem**, or **deterministic graphs**.
- They need **MCP** access to validation / compile / ecosystem listing (`ainl-mcp`).

## Install (pick one)

1. **From this skill directory (recommended with `zeroclaw skills install`):** run `./install.sh`  
   That upgrades `ainl[mcp]` and runs **`ainl install-mcp --host zeroclaw`** (pip self-upgrade, MCP registration hints, `~/.zeroclaw/bin/ainl-run` shim).

2. **Manual:**  
   `pip install 'ainativelang[mcp]' && ainl install-mcp --host zeroclaw`

### Restricted environments (OpenClaw, Clawbot, webchat sandboxes)

This skill is designed for environments with **PEP 668 externally-managed Python** (Python 3.13+, sudo blocked).

- Preferred no-root order is: `python -m venv` first, then `--user`, then `--break-system-packages` as a last resort.
- The installer automatically uses compatible fallback modes when default pip fails.
- Clean uninstall (if needed):

```bash
pip3 uninstall -y ainl mcp aiohttp langgraph temporalio
rm -rf /tmp/ainl-repo /data/.openclaw/workspace/skills/ainl /data/.local/lib/python3.13/site-packages/*ainl*
```

## Commands the user cares about

| Command | Purpose |
|--------|---------|
| `ainl import …` | Import Markdown or ecosystem sources into `.ainl` |
| `ainl compile …` | Compile / validate graphs |
| `ainl run …` | Execute a graph via the CLI runtime where applicable |
| `zeroclaw ainl run <file.ainl>` | After bootstrap: wrapper that compiles/runs through the installed shim |

## After install — prompt suggestion

Tell the user they can say in ZeroClaw:

> Import the morning briefing using AINL.

(They should point the importer at their Markdown or pack; `ainl import` subcommands match their source type.)

## MCP

Configure the host to run **`ainl-mcp`** as a stdio MCP server (see AINL docs: *External orchestration* / MCP). **`ainl install-mcp --host zeroclaw`** aligns local setup with ZeroClaw paths where applicable. Authoring tools include **`ainl_get_started`** (pass **`wizard_state_json`** to continue), **`ainl_step_examples`** (snippets by topic), validate/compile responses with **`contract_validation_status`**, and resources **`ainl://strict-valid-examples`** and **`ainl://strict-valid-families`**. See repo **`AGENTS.md`** and **`docs/operations/MCP_AINL_WIZARD_AND_CORPUS.md`**.

## References

- Upstream: [github.com/sbhooley/ainativelang](https://github.com/sbhooley/ainativelang)
- Package: **`ainativelang`** on PyPI