From 462a4b83ce746d90fe14b82e5c135acaa85cd4be Mon Sep 17 00:00:00 2001
From: Kirill Korikov <11762090+yourconscience@users.noreply.github.com>
Date: Tue, 25 Aug 2026 14:00:53 +0400
Subject: [PATCH] site: render table footnotes as separate lines
---
README.md | 15 +++------------
docs/site/index.html | 6 ++++--
2 files changed, 7 insertions(+), 14 deletions(-)
diff --git a/README.md b/README.md
index 703e29e..e779f89 100644
--- a/README.md
+++ b/README.md
@@ -49,18 +49,11 @@ Five surfaces, each rendered into the harness's own format — dotagents does no
† OpenCode reads `~/.agents/skills/` natively; its only hook surface is a JS plugin API.
‡ OMP has no managed hook surface yet; register memory hooks manually if needed.
-Amp and OpenClaw can read the repo's skills through standard conventions but are not managed; a surface gets a "yes" above only after its native behavior is verified end to end.
+Amp and OpenClaw read the repo's skills via standard conventions but are not managed. A "yes" above only appears after end-to-end verification.
## Skills
-A skill is a directory under `~/.agents/skills/` with a `SKILL.md` ([agentskills.io](https://agentskills.io) convention). Create once, appears everywhere:
-
-```bash
-dotagents skill new review-checklist --description "Pre-merge review checklist"
-dotagents sync
-```
-
-External skills from other people's repos are treated like dependencies: pinned to an exact commit in `dotagents.lock`, materialized into your repo for diffing, audited by `dotagents doctor`. See [docs/skills.md](docs/skills.md).
+A skill is a directory under `~/.agents/skills/` with a `SKILL.md` ([agentskills.io](https://agentskills.io) convention) — create once, appears everywhere. External skills are treated like dependencies: pinned in `dotagents.lock`, materialized for diffing, audited by `dotagents doctor`. Details in [docs/skills.md](docs/skills.md).
## Memory
@@ -109,9 +102,7 @@ scripts/release.sh v0.7.0 # verify + tag; CI publishes binaries, brew tap, np
- [docs/comparison.md](docs/comparison.md) — how dotagents differs from rulesync, ruler, openskills
- [Troubleshooting](docs/troubleshooting.md)
-## How it differs
-
-Project-level generators (rulesync, ruler) win on tool breadth; dotagents is user-level: one private repo that follows you across machines, seven targets deep, with pinned and audited external skills and a review-first memory workflow. Full table in [docs/comparison.md](docs/comparison.md).
+Project-level generators (rulesync, ruler) win on tool breadth; dotagents is user-level — one private repo, seven targets deep, pinned externals, review-first memory. Full table in [docs/comparison.md](docs/comparison.md).
## License
diff --git a/docs/site/index.html b/docs/site/index.html
index ba4893d..2919956 100644
--- a/docs/site/index.html
+++ b/docs/site/index.html
@@ -397,14 +397,16 @@ Sync surface by harness
- * Vanilla pi is skills-only by design; the OMP fork is detected as its own target. ‡ OMP has no managed hook surface in dotagents.yaml yet. † OpenCode reads ~/.agents/skills/ natively, so skills need no mirror when the config root is ~/.agents; hooks are a JS plugin surface only.
+ * Vanilla pi is skills-only by design; the OMP fork is detected as its own target.
+ † OpenCode reads ~/.agents/skills/ natively — skills need no mirror when the config root is ~/.agents. Its only hook surface is a JS plugin API.
+ ‡ OMP has no managed hook surface in dotagents.yaml yet; register memory hooks manually if needed.
Landscape
- Project-level generators win on tool breadth. dotagents is user-level: one private repo that follows you across machines, six harnesses deep, with pinned and audited external skills — and a review-first memory workflow (rem) built in.
+ Project-level generators win on tool breadth. dotagents is user-level: one private repo across machines, seven targets deep, pinned and audited externals, review-first memory (rem) built in.
How it compares