the signals and their derived score are provisional and subject to change.
validate manually before sharing.
3cfbfe3a372430a423c93ec78c0dba352d526c4enone
@AGENTS.md
# AGENTS.md: Solnix agent skills
You are an agent working with **Solnix**: illumos (the open descendant of OpenSolaris)
whose whole system is built, configured and upgraded with Nix and the NixOS module
system. This file is the map of this repository and its rules. Read it, then load the
one skill the task needs.
CC0-1.0. Source of truth: <https://codeberg.org/solnix/skills>. Mirror:
<https://git.solnix.io/solnix-skills.git>. Served over MCP at `https://solnix.io/mcp`
(`find_skill`, `get_skill`, SEP-2640 <!-- How to read this: I am `site` (the front-end + cache_api repo for solnix.io).
See `infra/AGENTS.md` for cluster/deployment. The OS itself lives in the
separate solnix.git repo. -->
# AGENTS.md — solnix.io site
## Overview
The public front end for **Solnix** (static HTML/mdBook handbook) plus
`cache_api/` — the Phoenix/Elixir service behind the REST/GraphQL/MCP search API,
the binary-cache read/submit paths, telemetry, and mail/moderation web actions.
## Key facts
- **Served at** http---
name: solnix-porter
description: >
Port Linux software to Solnix and illumos, or package it as a Solnix recipe:
configure/cmake/meson platform detection, undefined socket or getaddrinfo symbols
(-lsocket -lnsl), the illumos link editor (RUNPATH, $ORIGIN, mapfiles, elfdump,
elfedit, lari), epoll vs event ports, sendfile and /proc differences, GNU vs
/usr/xpg4 tools in build scripts, wrong-endianness configure probes under gcc 14,
leaks with libumem, crashes with mdb, LX zones vs a native port---
name: solnix-sysadmin
description: >
Run Solnix machines: SMF services, ZFS pools, datasets and snapshots, boot
environments and rollback, zones (LX zones are planned), Crossbow networking (dladm, ipadm,
flowadm), FMA faults, RBAC and pfexec, DTrace, users and updates. Use when a service
is down or in maintenance, a disk or pool needs work, a change needs a safe rollback,
a zone or network link needs setting up, a fault is reported, or someone asks how
to do on Solnix what they do with syste---
name: solnix-rules
description: >
The shared Solnix rule library the persona skills point into: one rule per file on
SMF, ZFS, boot environments, zones, Crossbow networking, FMA, RBAC, DTrace, users and
updates, build systems, the illumos link editor, event ports, libc and /proc
differences, GNU vs xpg4 tools, configure traps, libumem, mdb, and Solnix recipes.
Load a single rule when a persona names it, or when a task spans several personas.
license: CC0-1.0
metadata:
author: solnix
versio---
name: solnix-user
description: >
Use Solnix as a command-line user: find and install software from the
signed binary cache, run it, understand why a familiar Linux/BSD command behaves
differently, and recover after a boot-environment rollback. Use when someone asks to
install a package, what a command does on Solnix, or why their system looks
different after a rollback. For running services, storage and zones use
solnix-sysadmin; for building or porting software use solnix-porter.
license: C---
name: solnix-illumos-dev
description: >
Work on illumos-gate itself from a Solnix context: find code, history and issues in
illumos-gate with this server's index, and the pointers for building, debugging and the
request to integrate (RTI). A stub: builds, CTF, mdb/kmdb and DTrace providers are not
written yet. Use when changing the illumos kernel, libc or base commands, or preparing a
change for upstream illumos.
license: CC0-1.0
metadata:
author: solnix
version: "0.1.0"
persona: illumos---
name: solnix-builder
description: >
Operate a Solnix builder or understand the binary cache: the rebuild queue, the
submit flow (unsigned NARs, the site signs), reproduction votes, publish gates. Use
when running a builder, submitting to cache.solnix.io, or explaining why a path is
or isn't served.
license: CC0-1.0
metadata:
author: solnix
version: "0.1.0"
persona: builder
status: draft from the build team's builder-queue steering and site/skills SOLNIX-CACHE-OPERATOR; awaiting build-tea---
name: solnix-contributor
description: >
Contribute to Solnix: send a patch by email, report a bug or a security issue the
right way, write documentation in the project's voice. Use when preparing a patch
for hackers@solnix.io, a security report, or a handbook chapter. For upstream
illumos or nixpkgs contributions see steering/upstream-ai-policies.md.
license: CC0-1.0
metadata:
author: solnix
version: "0.1.0"
persona: contributor
status: migrated from site/skills SOLNIX-CONTRIBUTOR, SOLNI---
name: solnix-nix-dev
description: >
Write Nix for Solnix: the x86_64-solaris and aarch64-solaris platforms, the
pkgs.solnix.* namespace, the illumos stdenv and link editor, SMF modules
(smf.services), boot environments as generations. Use when writing or reviewing a
Solnix derivation, module or recipe row. Porting the software itself is
solnix-porter.
license: CC0-1.0
metadata:
author: solnix
version: "0.1.0"
persona: nix-dev
status: draft from the build team's steering, migrated from # Solnix
> Solnix is a distribution of illumos built with the Nix package manager and the NixOS module system: declarative machines, ZFS boot environments as generations, SMF instead of systemd. A signed binary cache for x86_64-solaris and aarch64-solaris, full-text package search, man pages, and a long-form handbook are live today; a text install image (TUI, wifi) is in dev-preview. The COSMIC desktop runs on one reference laptop (ThinkPad X1 Extreme Gen 5, Intel graphics); there is no graphical install i.gitignoreunspecified.mcp.json