{ "version": 1, "repo": "https://codeberg.org/solnix/skills", "skills": [ { "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.", "dir": "solnix/builder", "files": [ { "path": "solnix/builder/SKILL.md", "digest": "sha256:589ed196d823d70eb9244ba022db19e70efa4d7fe2e44b3fd074a64634ef5686", "size": 2225 } ] }, { "name": "solnix-contributor", "description": "Contribute to Solnix: send a patch by email to hackers@solnix.io (a recipe change, a new package or a version bump, a module, a fix to these skills), follow the email-patch governance (+1/0/-1 votes, OWNERS, timers, quorums), report a bug or a security issue the right way, write handbook documentation. Says which team owns what (the build team: the Solnix OS repo; the infra team: solnix.io, the cache, its signing and the queue). Use when preparing a patch, a cover letter, a bug or security report, or a handbook chapter. For upstream illumos or nixpkgs see steering/upstream-ai-policies.md; for changing illumos-gate itself, solnix-illumos-dev.", "dir": "solnix/contributor", "files": [ { "path": "solnix/contributor/SKILL.md", "digest": "sha256:afe0ac3ed82a8b6192337d005ec902ff9323b5e2c73d0c5ca1fa9838df0a2492", "size": 8996 } ] }, { "name": "solnix-illumos-dev", "description": "Change illumos-gate itself from a Solnix context: find code, history, reviewers and open issues with this server's illumos-gate index; build the gate with nightly and bldenv; run git pbchk, cstyle, hdrchk, wsdiff and check_rtime; debug the kernel with mdb, kmdb, CTF and DTrace (fbt, sdt, adding a DTRACE_PROBE); send a change upstream through an illumos issue, code review and a request to integrate (RTI). Use when changing the illumos kernel, a driver, libc or a base command, reading a kernel crash dump, or preparing a gate change for upstream. Says what Solnix takes from the gate (the proto area, through Nix); it keeps no IPS packages and has no pkg, which onu needs. Porting other software is solnix-porter.", "dir": "solnix/illumos-dev", "files": [ { "path": "solnix/illumos-dev/SKILL.md", "digest": "sha256:5c6da4caa10fe8df134cdd8946bac3bcd1cf2b8cfe37350c1b856432d31c39b4", "size": 12306 } ] }, { "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.", "dir": "solnix/nix-dev", "files": [ { "path": "solnix/nix-dev/SKILL.md", "digest": "sha256:c076a99d14d7204c341bcb1418bec782496174f557f75d032748a2ef686dd2e0", "size": 3031 } ] }, { "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. Use when a build fails or a binary misbehaves on Solnix, or when writing a recipe.", "dir": "solnix/porter", "files": [ { "path": "solnix/porter/SKILL.md", "digest": "sha256:386f6f0472d614ec9fc95e0305461c16b64863a4e36c29d853da16d15d626201", "size": 5251 } ] }, { "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.", "dir": "solnix/rules", "files": [ { "path": "solnix/rules/SKILL.md", "digest": "sha256:280c608f6b1828991972c8ecccd8537c9ca0c8d95da400d5411220530e6c2cd4", "size": 2969 }, { "path": "solnix/rules/_template.md", "digest": "sha256:cf13bd41581418b3204cb9472b1606057d21f0a62ce12f1acbb670db81d9dac4", "size": 1134 }, { "path": "solnix/rules/api-event-ports-vs-epoll.md", "digest": "sha256:a5ca3a271b6dd791a5bcb43f873601d8e0bf8fa75aedb688ff4405dd3c71a3c7", "size": 8656 }, { "path": "solnix/rules/api-sendfile-proc-pthreads-libc.md", "digest": "sha256:db3939b92c277d2e97ec8bde984b53b577452b4313c661e8f9930f18c2f3c7ba", "size": 8383 }, { "path": "solnix/rules/be-generations-and-rollback.md", "digest": "sha256:fcf6fec2dfeb4e938e1ad650e03b34e841385370ef8cd0703c5fbbe996495eb8", "size": 7655 }, { "path": "solnix/rules/build-autotools-cmake-meson.md", "digest": "sha256:5bff816e27e67e8351ec5b6572727305aa85c77e6f72d69cc54b9fd32ab76899", "size": 10267 }, { "path": "solnix/rules/build-endianness-probe-trap.md", "digest": "sha256:3cd4a044b60a447ceece112d9b67a1145f6b875228d2996158483bb8875d7dc9", "size": 6030 }, { "path": "solnix/rules/build-gcc14-implicit-declarations.md", "digest": "sha256:92b59938a3681d12e554c58a59e5f2bddd26f5d41d6ae40a7d89980d7ccd4510", "size": 6553 }, { "path": "solnix/rules/contrib-send-a-recipe-change.md", "digest": "sha256:b3cf9d030433548a11181353f5aec2e47457466a26439874364e87e2b7972235", "size": 9526 }, { "path": "solnix/rules/debug-libumem-leaks.md", "digest": "sha256:db3ba4ba5f5cd226d7e6d104b54e6f051fc96a8379b117c893e893bc83e58102", "size": 8337 }, { "path": "solnix/rules/debug-mdb-postmortem.md", "digest": "sha256:6f8663acb7c79a7d806c3024a6a79a074596bb19554f73760aeb81877d8c0385", "size": 8536 }, { "path": "solnix/rules/dtrace-for-admins.md", "digest": "sha256:f8a389dd0fffd25cba3ec24fb75f6a9e3788c1c1476291c74df98f9bfce2bbd8", "size": 6834 }, { "path": "solnix/rules/fma-faults.md", "digest": "sha256:754088ccf2f1b5ce2de55f41b8f4a30a0fba46ceedcf156b57a6e73f07b5c67b", "size": 4877 }, { "path": "solnix/rules/gate-build-nightly-bldenv.md", "digest": "sha256:6f563ee96d2746fd16d226bc54ef1cc0f6fd2c5c25cd4aefea1727827b88bd53", "size": 9546 }, { "path": "solnix/rules/gate-checks-pbchk-cstyle.md", "digest": "sha256:16092d06832423ef3b5ab99c45c3f4a0e88ed2fab18709e69a8454c1dd70da9f", "size": 6889 }, { "path": "solnix/rules/gate-upstream-rti.md", "digest": "sha256:0a378a35b6f478532ad1c95c5df268ccdcfe613bbc3aceb6a54753d59819abb0", "size": 7594 }, { "path": "solnix/rules/link-lsocket-lnsl.md", "digest": "sha256:99f89d36c708ff970dbe0769024c8428325f2ed88a052e02167ffc0fea2dd0e1", "size": 7592 }, { "path": "solnix/rules/link-mapfiles-and-lari.md", "digest": "sha256:38781eea710b169a12e508c27050d946db285036b9e36ceb274dd5648e0eb8f1", "size": 6766 }, { "path": "solnix/rules/link-runpath-origin.md", "digest": "sha256:c8a88192511ef926db0ced9f94d60a24cc18e89d8cf95fd7e4fe0c736ba84955", "size": 8897 }, { "path": "solnix/rules/lx-vs-native.md", "digest": "sha256:e34ceb6779358943900b23bef209d7533f30112c5e0c37afc2d990660ebb6538", "size": 7821 }, { "path": "solnix/rules/net-crossbow-dladm-ipadm.md", "digest": "sha256:3f1740f7c8882af2013e5beb0ac91ed5b1124710bb89940d157fd7145832ab0f", "size": 8519 }, { "path": "solnix/rules/rbac-pfexec.md", "digest": "sha256:a1dd0846acb8535bbe9c5d5b1eae4fee9fb50d58cf9bec55b10dee9c3ebf5cc8", "size": 8328 }, { "path": "solnix/rules/recipe-write-a-solnix-recipe.md", "digest": "sha256:2f3fce8aea33c3118a0cfeec3e62b0b9952b2e23a8bf7badea475dc162da7e7e", "size": 11488 }, { "path": "solnix/rules/shell-xpg4-vs-gnu.md", "digest": "sha256:027d8ddf118d390a6e50d6686093ebc8b93dd3547e00c0df5a4c631de18cc6f8", "size": 8832 }, { "path": "solnix/rules/smf-declare-services.md", "digest": "sha256:ec0fd3cc150cf96832a5f3b6a7343aa5d42271c008dc71a351763d4fe242a811", "size": 7997 }, { "path": "solnix/rules/smf-diagnose-failures.md", "digest": "sha256:4f4312bcdc73da07ae7d0dc0e7dbc5729de3b63e1424b5fa454537450a3a9951", "size": 7737 }, { "path": "solnix/rules/smf-temporary-vs-persistent.md", "digest": "sha256:276f00abea07c6d08198a30d49a16ed132eb92652b4761d59514cec7205121ac", "size": 7132 }, { "path": "solnix/rules/users-and-updates-solnix-way.md", "digest": "sha256:cf8d9158f07e7744583067beadd44dd380d8b772c41edc53059a28ff3b6bb9ca", "size": 8112 }, { "path": "solnix/rules/zfs-datasets-and-properties.md", "digest": "sha256:85cae2faa6ace7891ec1988be3a9e4152f15d73d65ab97356244018e9049f772", "size": 8170 }, { "path": "solnix/rules/zfs-snapshots-send-receive.md", "digest": "sha256:975c871cf154d19e6475c8fb590042046281446a6d0b5264a8007cb81d789670", "size": 6214 }, { "path": "solnix/rules/zones-lx.md", "digest": "sha256:77e9d55670fd1b6954cd3b2241f8229fd937e1c688b4c11140253c50de2f0d21", "size": 5835 }, { "path": "solnix/rules/zones-native.md", "digest": "sha256:17923a38b2560dba53587f7ce8ad9708b73b903b10399789e9888499696ef336", "size": 6671 } ] }, { "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 systemctl, ip, useradd or apt. For porting or building software use solnix-porter.", "dir": "solnix/sysadmin", "files": [ { "path": "solnix/sysadmin/SKILL.md", "digest": "sha256:f343945a77211544ec18a53f78ca43bcbf9df6396dd27c5dd62e9ae50adb679d", "size": 5547 } ] }, { "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.", "dir": "solnix/user", "files": [ { "path": "solnix/user/SKILL.md", "digest": "sha256:8ba19a33ad334b116ec4c286477dd96d87bc2b4a2400eebda744b073f0a5622e", "size": 5037 } ] } ], "shared": [ { "path": "solnix/rules/SKILL.md", "digest": "sha256:280c608f6b1828991972c8ecccd8537c9ca0c8d95da400d5411220530e6c2cd4", "size": 2969 }, { "path": "solnix/rules/_template.md", "digest": "sha256:cf13bd41581418b3204cb9472b1606057d21f0a62ce12f1acbb670db81d9dac4", "size": 1134 }, { "path": "solnix/rules/api-event-ports-vs-epoll.md", "digest": "sha256:a5ca3a271b6dd791a5bcb43f873601d8e0bf8fa75aedb688ff4405dd3c71a3c7", "size": 8656 }, { "path": "solnix/rules/api-sendfile-proc-pthreads-libc.md", "digest": "sha256:db3939b92c277d2e97ec8bde984b53b577452b4313c661e8f9930f18c2f3c7ba", "size": 8383 }, { "path": "solnix/rules/be-generations-and-rollback.md", "digest": "sha256:fcf6fec2dfeb4e938e1ad650e03b34e841385370ef8cd0703c5fbbe996495eb8", "size": 7655 }, { "path": "solnix/rules/build-autotools-cmake-meson.md", "digest": "sha256:5bff816e27e67e8351ec5b6572727305aa85c77e6f72d69cc54b9fd32ab76899", "size": 10267 }, { "path": "solnix/rules/build-endianness-probe-trap.md", "digest": "sha256:3cd4a044b60a447ceece112d9b67a1145f6b875228d2996158483bb8875d7dc9", "size": 6030 }, { "path": "solnix/rules/build-gcc14-implicit-declarations.md", "digest": "sha256:92b59938a3681d12e554c58a59e5f2bddd26f5d41d6ae40a7d89980d7ccd4510", "size": 6553 }, { "path": "solnix/rules/contrib-send-a-recipe-change.md", "digest": "sha256:b3cf9d030433548a11181353f5aec2e47457466a26439874364e87e2b7972235", "size": 9526 }, { "path": "solnix/rules/debug-libumem-leaks.md", "digest": "sha256:db3ba4ba5f5cd226d7e6d104b54e6f051fc96a8379b117c893e893bc83e58102", "size": 8337 }, { "path": "solnix/rules/debug-mdb-postmortem.md", "digest": "sha256:6f8663acb7c79a7d806c3024a6a79a074596bb19554f73760aeb81877d8c0385", "size": 8536 }, { "path": "solnix/rules/dtrace-for-admins.md", "digest": "sha256:f8a389dd0fffd25cba3ec24fb75f6a9e3788c1c1476291c74df98f9bfce2bbd8", "size": 6834 }, { "path": "solnix/rules/errors.tsv", "digest": "sha256:e9f6302f553af2318753db9bd8d90a39688776ac0d9d3e65b36ac95743bfa844", "size": 20793 }, { "path": "solnix/rules/fma-faults.md", "digest": "sha256:754088ccf2f1b5ce2de55f41b8f4a30a0fba46ceedcf156b57a6e73f07b5c67b", "size": 4877 }, { "path": "solnix/rules/gate-build-nightly-bldenv.md", "digest": "sha256:6f563ee96d2746fd16d226bc54ef1cc0f6fd2c5c25cd4aefea1727827b88bd53", "size": 9546 }, { "path": "solnix/rules/gate-checks-pbchk-cstyle.md", "digest": "sha256:16092d06832423ef3b5ab99c45c3f4a0e88ed2fab18709e69a8454c1dd70da9f", "size": 6889 }, { "path": "solnix/rules/gate-upstream-rti.md", "digest": "sha256:0a378a35b6f478532ad1c95c5df268ccdcfe613bbc3aceb6a54753d59819abb0", "size": 7594 }, { "path": "solnix/rules/link-lsocket-lnsl.md", "digest": "sha256:99f89d36c708ff970dbe0769024c8428325f2ed88a052e02167ffc0fea2dd0e1", "size": 7592 }, { "path": "solnix/rules/link-mapfiles-and-lari.md", "digest": "sha256:38781eea710b169a12e508c27050d946db285036b9e36ceb274dd5648e0eb8f1", "size": 6766 }, { "path": "solnix/rules/link-runpath-origin.md", "digest": "sha256:c8a88192511ef926db0ced9f94d60a24cc18e89d8cf95fd7e4fe0c736ba84955", "size": 8897 }, { "path": "solnix/rules/lx-vs-native.md", "digest": "sha256:e34ceb6779358943900b23bef209d7533f30112c5e0c37afc2d990660ebb6538", "size": 7821 }, { "path": "solnix/rules/net-crossbow-dladm-ipadm.md", "digest": "sha256:3f1740f7c8882af2013e5beb0ac91ed5b1124710bb89940d157fd7145832ab0f", "size": 8519 }, { "path": "solnix/rules/rbac-pfexec.md", "digest": "sha256:a1dd0846acb8535bbe9c5d5b1eae4fee9fb50d58cf9bec55b10dee9c3ebf5cc8", "size": 8328 }, { "path": "solnix/rules/recipe-write-a-solnix-recipe.md", "digest": "sha256:2f3fce8aea33c3118a0cfeec3e62b0b9952b2e23a8bf7badea475dc162da7e7e", "size": 11488 }, { "path": "solnix/rules/shell-xpg4-vs-gnu.md", "digest": "sha256:027d8ddf118d390a6e50d6686093ebc8b93dd3547e00c0df5a4c631de18cc6f8", "size": 8832 }, { "path": "solnix/rules/smf-declare-services.md", "digest": "sha256:ec0fd3cc150cf96832a5f3b6a7343aa5d42271c008dc71a351763d4fe242a811", "size": 7997 }, { "path": "solnix/rules/smf-diagnose-failures.md", "digest": "sha256:4f4312bcdc73da07ae7d0dc0e7dbc5729de3b63e1424b5fa454537450a3a9951", "size": 7737 }, { "path": "solnix/rules/smf-temporary-vs-persistent.md", "digest": "sha256:276f00abea07c6d08198a30d49a16ed132eb92652b4761d59514cec7205121ac", "size": 7132 }, { "path": "solnix/rules/tasks.tsv", "digest": "sha256:cd3f8de9ea6ada794fea997b2e55effbcdad9dcc6dc5c59e2242a5019568ae9e", "size": 65851 }, { "path": "solnix/rules/users-and-updates-solnix-way.md", "digest": "sha256:cf8d9158f07e7744583067beadd44dd380d8b772c41edc53059a28ff3b6bb9ca", "size": 8112 }, { "path": "solnix/rules/zfs-datasets-and-properties.md", "digest": "sha256:85cae2faa6ace7891ec1988be3a9e4152f15d73d65ab97356244018e9049f772", "size": 8170 }, { "path": "solnix/rules/zfs-snapshots-send-receive.md", "digest": "sha256:975c871cf154d19e6475c8fb590042046281446a6d0b5264a8007cb81d789670", "size": 6214 }, { "path": "solnix/rules/zones-lx.md", "digest": "sha256:77e9d55670fd1b6954cd3b2241f8229fd937e1c688b4c11140253c50de2f0d21", "size": 5835 }, { "path": "solnix/rules/zones-native.md", "digest": "sha256:17923a38b2560dba53587f7ce8ad9708b73b903b10399789e9888499696ef336", "size": 6671 }, { "path": "steering/README.md", "digest": "sha256:dd26bee30797264baecaebeaf71f9387a1232a1a6e15a5d40d4f0317bd5f2878", "size": 1619 }, { "path": "steering/confirm-destructive.md", "digest": "sha256:e0ba12d361772f8c4d980b96e04a8595b2d87d67f9a128e84f4ff5aac5396410", "size": 3402 }, { "path": "steering/edition-policy.md", "digest": "sha256:b66f5ab6418f04a4e8b5c42a52c40b3c165cbf7dd3eff03399afebc02c0aac6c", "size": 762 }, { "path": "steering/email-patch-governance.md", "digest": "sha256:cfddfac434d2c5b52c8deff1c52c9e15fe25b73cb4e60ddbb41f02c406bfe387", "size": 1059 }, { "path": "steering/honesty-over-hype.md", "digest": "sha256:de21ad47e512f0315c4fe9c542db271a5cbeb07ab78013adb13a1b0d8a83e0ee", "size": 1277 }, { "path": "steering/privacy.md", "digest": "sha256:229b7424ad667e9fa5ede0985d503c47149deda830963513aba68671ea2dec85", "size": 939 }, { "path": "steering/query-first.md", "digest": "sha256:03a4170fa52754054eb7337aaa5c753d03d33d351b9276c1bc5de699791e21f1", "size": 1730 }, { "path": "steering/reproducibility-as-trust.md", "digest": "sha256:03092524cb215ad7a89f32a540c6c1a19ff58a07a3b6e24da8a22880de6bdfb9", "size": 904 }, { "path": "steering/solnix-is-not-upstream-illumos.md", "digest": "sha256:95da1b5ce661d342403f963d3ed2f550cc933e8e587bd79a1e8d7731fdf6d10c", "size": 3530 }, { "path": "steering/trust-and-signing.md", "digest": "sha256:d79e163d7e8c2d21f16fb1ce120548cf10d9f09929c2b992210ac27303a392f8", "size": 716 }, { "path": "steering/upstream-ai-policies.md", "digest": "sha256:1072bf93e0f83aa44ef5140b2f94631446da2bba7a486f0a0ef1b37425152162", "size": 1167 }, { "path": "steering/voice.md", "digest": "sha256:ee1952bd2642c5a7ad0c7c4b8a6de44d86da53a801d87ea1a3dadf3bd657c537", "size": 1020 }, { "path": "workflows/install-a-package.md", "digest": "sha256:5b31ad138b0cc1d1033eb4093b5bd590be742724de0e95dd2ca0af484f93d6be", "size": 1182 }, { "path": "workflows/port-a-linux-package.md", "digest": "sha256:a2fcb18a002b1bc1a8c4e03d96c516a694600ec1fb1c2c2c02c5189b4c13b7d1", "size": 688 }, { "path": "workflows/report-a-cve.md", "digest": "sha256:3a327cb2766a1dbb9df80d92426a894ff2567db8f898c5340b8439c47a0fde70", "size": 656 }, { "path": "workflows/reproduce-and-vote.md", "digest": "sha256:4988278f4b81b2d06d8cb150e1d3cac31c5f106522c35d14ec404f9a3017ea22", "size": 834 }, { "path": "workflows/review-a-rule.md", "digest": "sha256:7a33914933b301ee590bf25c226c6cb156e2eafd08b8c0548d1d0fbba2bcbb9f", "size": 1073 }, { "path": "workflows/roll-back-an-update.md", "digest": "sha256:f8b3d70bf82cf3d873a96dd8360ff849afbdc599aa590c748851c78b84313a6a", "size": 797 }, { "path": "workflows/triage-a-failed-service.md", "digest": "sha256:7d03c5878f4133b486e2c18d803a3f705f073703f23ebb85d9a8367a1e7c9513", "size": 1028 } ] }