# agents.txt
# Standard: https://agents-txt.com
# JSON: https://solnix.io/agents.json
#
# Solnix: a distribution of illumos built with Nix. This site is built to be
# QUERIED, not scraped. Prefer the MCP server; fall back to REST/GraphQL.

MCP: https://solnix.io/mcp

# One MCP call returns cited passages across packages, man pages, and the
# handbook. Start with:
#   solnix_search {"query": "...", "kinds": ["packages","manpages","handbook"]}

# REST (OpenAPI): https://solnix.io/api  |  GraphQL: https://solnix.io/graphql
# Tool reference: https://solnix.io/mcp-tools
# Compact site index: https://solnix.io/llms.txt

# --- Role skills — load the one matching the task (illumos + Nix) ---
Skills: https://solnix.io/skills/SOLNIX-USER.md
Skills: https://solnix.io/skills/SOLNIX-PACKAGER.md
Skills: https://solnix.io/skills/SOLNIX-MAINTAINER.md
Skills: https://solnix.io/skills/SOLNIX-ADMIN.md
Skills: https://solnix.io/skills/SOLNIX-CONTRIBUTOR.md
Skills: https://solnix.io/skills/SOLNIX-CACHE-OPERATOR.md
Skills: https://solnix.io/skills/SOLNIX-HANDBOOK-WRITER.md

# --- Steering: how the Solnix project thinks and communicates ---
Skills: https://solnix.io/skills/community/steering/voice.md
Skills: https://solnix.io/skills/community/steering/honesty-over-hype.md
Skills: https://solnix.io/skills/community/steering/reproducibility-as-trust.md
Skills: https://solnix.io/skills/community/steering/edition-policy.md
Skills: https://solnix.io/skills/community/steering/email-patch-governance.md
Skills: https://solnix.io/skills/community/steering/trust-and-signing.md
Skills: https://solnix.io/skills/community/steering/privacy.md

# --- Conventions: the project's rules ---
Skills: https://solnix.io/skills/community/conventions/recipe-schema.md
Skills: https://solnix.io/skills/community/conventions/signed-submit.md
Skills: https://solnix.io/skills/community/conventions/illumos-elf-runpath.md
Skills: https://solnix.io/skills/community/conventions/smf-manifests.md
Skills: https://solnix.io/skills/community/conventions/boot-environments.md
Skills: https://solnix.io/skills/community/conventions/nix-on-illumos.md

# --- Workflows: step-by-step procedures ---
Skills: https://solnix.io/skills/generic/workflows/install-a-package.md
Skills: https://solnix.io/skills/generic/workflows/submit-a-package.md
Skills: https://solnix.io/skills/generic/workflows/reproduce-and-vote.md
Skills: https://solnix.io/skills/generic/workflows/bump-a-version.md
Skills: https://solnix.io/skills/generic/workflows/report-a-cve.md
Skills: https://solnix.io/skills/generic/workflows/add-a-manpage.md
Skills: https://solnix.io/skills/generic/workflows/write-a-handbook-chapter.md