chore(agent): drop .claude/skills — AGENTS.md carries the routing
All checks were successful
Check / eval (push) Successful in 4m44s

The skill shims became redundant once the auto-loaded entry point
(CLAUDE.md → AGENTS.md) explicitly instructs reading VERIFICATION.md /
THEME-DESIGN.md; their only remaining value was explicit /nomarchy and
/theme invocation. The adapter is now permissions + subagent defs only.
References updated (AGENTS.md, agent/README.md, docs/README.md, README
tree, MEMORY.md hygiene note).

Verification: V0 (docs/meta only).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Bernardo Magri
2026-07-11 09:06:32 +01:00
parent dafa83e922
commit 5ef66c242e
7 changed files with 9 additions and 44 deletions

View File

@@ -1,22 +0,0 @@
---
name: nomarchy
description: Development and maintenance workflow for the Nomarchy NixOS-based distribution (this repository). Use this skill for ANY change to this repo — new features, bug fixes, theming or visual work (Hyprland, Waybar, rofi, wallpapers, palettes), NixOS/Home-Manager module changes, flake lock bumps, theme imports, docs updates, backlog grooming, or loop iterations. Trigger even for "small" or "obvious" changes; the whole point of this skill is that no change ships without climbing the verification ladder, and small changes are where verification gets skipped.
---
# Nomarchy Development Skill
This repo is maintained by agents from multiple vendors, so the skill
body lives vendor-neutrally in the repo — this file only routes you
there. Read, then follow:
1. **`AGENTS.md`** — entry point: where everything lives, standing rules
2. **`agent/LOOP.md`** — the iteration protocol + the V0V3 ladder
3. **`agent/VERIFICATION.md`** — the enforcement rules: preflight, the
honesty rules, the visual verification protocol, hardware-blocked
checks, maintenance work, the reporting format
4. **`agent/DELEGATION.md`** — capability tiers, the scout/runner roles
(Claude Code defs: `.claude/agents/`), token economy, parallel fan-out
Before running any VM test, also read **`docs/TESTING.md`**. The repo
docs always win over any cached summary of them; if docs disagree with
each other, fix the discrepancy in the same or a follow-up commit.

View File

@@ -1,12 +0,0 @@
---
name: theme
description: Theme design and visual work for Nomarchy — use whenever the user asks to create, update, refine, or troubleshoot themes or visual design (palettes, Hyprland looks, Waybar, Ghostty, btop, rofi, wallpapers, typography, icons).
---
# Nomarchy Theme Designer Skill
The skill body lives vendor-neutrally in the repo — read and follow
**`agent/THEME-DESIGN.md`**. Visual work additionally climbs the
verification ladder and visual protocol in **`agent/VERIFICATION.md`**
(scripted contrast/design checks first, then headless screenshots you
actually view).

View File

@@ -18,7 +18,7 @@ thin *adapter* (see bottom) and never holds shared content.
| **`docs/VISION.md`** | Product themes toward **v1.0** (not a queue) |
| **`docs/ROADMAP.md`** | Design history + shipped log |
| **`docs/README.md`** | Full documentation map |
| **`.claude/`** | Claude Code adapter only (permissions, subagents, skill shims) — not the backlog |
| **`.claude/`** | Claude Code adapter only (permissions, subagent defs) — not the backlog |
## If you're here to work autonomously (the loop)
Follow **`agent/LOOP.md`** — one iteration: orient → pick one BACKLOG

View File

@@ -86,7 +86,7 @@ Flat on purpose. Two module trees, one options file each, no hidden layers.
├── agent/ # agent instructions + loop state — map: agent/README.md
│ # BACKLOG (executable queue), LOOP, VERIFICATION, …
├── AGENTS.md # agent entry, any vendor (CLAUDE.md symlinks here)
├── .claude/ # Claude Code adapter: permissions + subagent/skill shims
├── .claude/ # Claude Code adapter: permissions + subagent defs
└── tools/ # maintainer-only
├── import-palettes.py # converts old-distro themes → JSON + assets
├── test-live-iso.sh # build the ISO + boot it in QEMU

View File

@@ -162,9 +162,9 @@ iteration would otherwise rediscover.
effects carry a value, matchers take `match:` (§ windowrule migration).
- grub `loadfont`s every `.pf2` in a theme dir — reuse a bundled DejaVu
rather than shipping fonts (§ Distro branding).
- `.claude/skills/*/SKILL.md` are **tracked thin shims** — the actual
instruction bodies live vendor-neutrally in `agent/` (VERIFICATION,
DELEGATION, THEME-DESIGN); edit those, not the shims. Still never
`git add -A` blindly: check `git status --short` for genuine strangers
first (`settings.local.json`, harness-dropped files) and commit with
explicit pathspecs (§ loop hygiene).
- Agent instructions live vendor-neutrally in `agent/` (VERIFICATION,
DELEGATION, THEME-DESIGN; entry AGENTS.md) — `.claude/` is a thin
adapter (permissions + subagent defs only; skills were removed
2026-07-11). Never `git add -A` blindly: check `git status --short`
for genuine strangers first (`settings.local.json`, harness-dropped
files) and commit with explicit pathspecs (§ loop hygiene).

View File

@@ -42,7 +42,6 @@ into the files above, in whatever format their harness requires.
| [../AGENTS.md](../AGENTS.md) | any | Entry point (`CLAUDE.md` is a symlink to it) |
| [../.claude/settings.json](../.claude/settings.json) | Claude Code | Tool permissions |
| [../.claude/agents/](../.claude/agents/) | Claude Code | `nomarchy-scout` / `nomarchy-runner` role defs (contracts in [DELEGATION.md](DELEGATION.md)) |
| [../.claude/skills/](../.claude/skills/) | Claude Code | Skill shims → VERIFICATION/DELEGATION/THEME-DESIGN |
Do **not** put backlog items, vision text, or policy under an adapter
directory — it is not shared with other agent runners.

View File

@@ -21,7 +21,7 @@ tree for the same facts.
|------|------|
| [../AGENTS.md](../AGENTS.md) | Agent entry point, any vendor/harness (`CLAUDE.md` symlinks to it) |
| [../agent/README.md](../agent/README.md) | Agent instructions + **executable** loop state: BACKLOG, LOOP, VERIFICATION, … |
| [../.claude/](../.claude/) | Claude Code adapter only: permissions + subagent/skill shims |
| [../.claude/](../.claude/) | Claude Code adapter only: permissions + subagent defs |
## How work flows