Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 3 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down
6 changes: 4 additions & 2 deletions docs/site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -397,14 +397,16 @@ <h3>Sync surface by harness</h3>
</tbody>
</table>
</div>
<p class="section-sub" style="margin-top:10px">* Vanilla pi is skills-only by design; the OMP fork is detected as its own target. &#8225; OMP has no managed hook surface in dotagents.yaml yet. &dagger; 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>
<p class="section-sub" style="margin-top:10px">* Vanilla pi is skills-only by design; the OMP fork is detected as its own target.</p>
<p class="section-sub" style="margin:4px 24px 4px; font-size: 13px">&dagger; 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>
<p class="section-sub" style="margin:4px 24px 12px; font-size: 13px">&#8225; OMP has no managed hook surface in <code>dotagents.yaml</code> yet; register memory hooks manually if needed.</p>
</div>
</section>

<!-- Landscape -->
<section>
<h2>Landscape</h2>
<p class="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>
<p class="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>

<div class="panel">
<h3>How it compares</h3>
Expand Down
Loading