You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+3-12Lines changed: 3 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -49,18 +49,11 @@ Five surfaces, each rendered into the harness's own format — dotagents does no
49
49
† OpenCode reads `~/.agents/skills/` natively; its only hook surface is a JS plugin API.
50
50
‡ OMP has no managed hook surface yet; register memory hooks manually if needed.
51
51
52
-
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.
52
+
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.
53
53
54
54
## Skills
55
55
56
-
A skill is a directory under `~/.agents/skills/` with a `SKILL.md` ([agentskills.io](https://agentskills.io) convention). Create once, appears everywhere:
57
-
58
-
```bash
59
-
dotagents skill new review-checklist --description "Pre-merge review checklist"
60
-
dotagents sync
61
-
```
62
-
63
-
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).
56
+
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).
-[docs/comparison.md](docs/comparison.md) — how dotagents differs from rulesync, ruler, openskills
110
103
-[Troubleshooting](docs/troubleshooting.md)
111
104
112
-
## How it differs
113
-
114
-
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).
105
+
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).
Copy file name to clipboardExpand all lines: docs/site/index.html
+4-2Lines changed: 4 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -397,14 +397,16 @@ <h3>Sync surface by harness</h3>
397
397
</tbody>
398
398
</table>
399
399
</div>
400
-
<pclass="section-sub" style="margin-top:10px">* 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 <code>~/.agents/skills/</code> natively, so skills need no mirror when the config root is <code>~/.agents</code>; hooks are a JS plugin surface only.</p>
400
+
<pclass="section-sub" style="margin-top:10px">* Vanilla pi is skills-only by design; the OMP fork is detected as its own target.</p>
401
+
<pclass="section-sub" style="margin:4px 24px 4px; font-size: 13px">† OpenCode reads <code>~/.agents/skills/</code> natively — skills need no mirror when the config root is <code>~/.agents</code>. Its only hook surface is a JS plugin API.</p>
402
+
<pclass="section-sub" style="margin:4px 24px 12px; font-size: 13px">‡ OMP has no managed hook surface in <code>dotagents.yaml</code> yet; register memory hooks manually if needed.</p>
401
403
</div>
402
404
</section>
403
405
404
406
<!-- Landscape -->
405
407
<section>
406
408
<h2>Landscape</h2>
407
-
<pclass="section-sub">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 (<code>rem</code>) built in.</p>
409
+
<pclass="section-sub">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 (<code>rem</code>) built in.</p>
0 commit comments