From 8255730404aaa2cbd80febae3a9de988ad491dcb Mon Sep 17 00:00:00 2001 From: Kirill Korikov <11762090+yourconscience@users.noreply.github.com> Date: Sat, 13 Jun 2026 20:02:09 +0200 Subject: [PATCH 1/2] add landing page and GitHub Pages deploy workflow --- .github/workflows/pages.yml | 30 +++ docs/site/index.html | 430 ++++++++++++++++++++++++++++++++++++ 2 files changed, 460 insertions(+) create mode 100644 .github/workflows/pages.yml create mode 100644 docs/site/index.html diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..426a020 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,30 @@ +name: Deploy to GitHub Pages +on: + push: + branches: [main] + paths: [docs/site/**] + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: true + +jobs: + deploy: + runs-on: ubuntu-latest + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - uses: actions/checkout@v4 + - uses: actions/configure-pages@v5 + - uses: actions/upload-pages-artifact@v3 + with: + path: docs/site + - id: deployment + uses: actions/deploy-pages@v4 diff --git a/docs/site/index.html b/docs/site/index.html new file mode 100644 index 0000000..34bc8e2 --- /dev/null +++ b/docs/site/index.html @@ -0,0 +1,430 @@ + + + + + +dotagents - one repo for all your coding agents + + + + +
+
+ + +
open source
+

One repo for all your coding agents.

+

+ dotagents keeps skills, MCP servers, hooks, and agent roles in one + ~/.agents directory and syncs them into native formats for every harness you use. + Add once, available everywhere. +

+ + +
+
+
+
+
+ ~/.agents +
+ 
$ dotagents status
+
+~/.agents synced from github.com/yourconscience/dotagents
+
+claude-code  synced   plugin delivery   11 skills  2 MCP  4 hooks
+codex        synced   27 skills  4 agent roles  2 MCP  5 hooks
+hermes       synced   27 skills  2 MCP  13 hooks
+droid        synced   27 skills  4 agent roles  2 MCP  5 hooks
+pi           synced   27 skills
+
+ + +
+

Supported harnesses

+

Managed harnesses get full sync: skills, MCP, hooks, roles. Compatibility harnesses get documented paths.

+ +
+ +
+
+ + + +
+
Claude Code
+
managed
+
+ +
+
+ + + +
+
Codex
+
managed
+
+ +
+
+ + + +
+
Factory Droid
+
managed
+
+ +
+
+ + + + + + + + +
+
Hermes
+
managed
+
+ +
+
+ + π + +
+
Pi
+
managed
+
+ +
+
+ + + + + +
+
Amp
+
compat
+
+ +
+
+ + + + +
+
OpenCode
+
compat
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
OpenClaw
+
compat
+
+
+
+ + +
+

Get started

+

Two paths. Plugin if you just want skills in Claude Code. CLI if you want the full sync layer.

+ +
+
+
Plugin
+

Claude Code marketplace

+

Install portable skills directly. No CLI, no clone.

+ 
> /plugin marketplace add yourconscience/dotagents
+> /plugin install tech-search@yourconscience
+
+ +
+
CLI
+

Full setup

+

Clone, install, sync. All detected agents get your skills, MCP, hooks, and roles.

+ 
$ git clone https://github.com/yourconscience/dotagents ~/.agents
+$ go install github.com/yourconscience/dotagents/cmd/dotagents@latest
+$ dotagents setup
+
+

Then add a skill and sync it everywhere:

+ 
$ mkdir skills/my-skill && cat > skills/my-skill/SKILL.md
+$ dotagents sync
+synced 28 skills to 5 harnesses
+
+
+
+
+ + +
+

What syncs

+

Not just skills. The full config surface that fragments across agents.

+ +
+

Sync surface by harness

+
+ + + + + + + + + +
HarnessSkillsAgent rolesMCPHooksRoot instructions
Claude CodeyesyesyesyesCLAUDE.md shim
CodexyesyesyesyesAGENTS.md
Factory DroidyesyesyesyesAGENTS link
Hermesyes--yesyesnative ctx
Piyes--yes--OMP ctx
+
+
+
+ + +
+

Alternatives

+

Other tools solve parts of this. dotagents covers the full surface across the post-IDE agent stack.

+ +
+

Comparison

+
+ + + + + + + + + + + + +
dotagentsskillsharevsyncagents-cli
Skills syncyesyesyesyes
MCP syncyesnoyesyes
Hooks syncyesnonono
Agent rolesyesnoyesno
Plugin catalogyesnonono
Skill pinningyesyesnono
Security audityesyesnono
Private overlayyesnonono
+
+
+
+ + + +
+ + From f60b521ecff58c48b163194c01dc90f12c54c26f Mon Sep 17 00:00:00 2001 From: Kirill Korikov <11762090+yourconscience@users.noreply.github.com> Date: Sat, 13 Jun 2026 20:49:11 +0200 Subject: [PATCH 2/2] fix contrast ratio and use semantic th scope=row in tables --- docs/site/index.html | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/site/index.html b/docs/site/index.html index 34bc8e2..5a7c041 100644 --- a/docs/site/index.html +++ b/docs/site/index.html @@ -82,11 +82,11 @@ font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; font-size: 15px; line-height: 1.7; color: #c8d0e0; overflow-x: auto; } - .p { color: #5a6378; } + .p { color: #7d8699; } .c { color: #e8edf7; font-weight: 600; } .g { color: var(--green); } .h { color: var(--orange); font-weight: 700; } - .d { color: #5a6378; } + .d { color: #7d8699; } /* Sections */ section { margin-top: 72px; } @@ -159,7 +159,7 @@ table { width: 100%; border-collapse: collapse; font-size: 14px; } th, td { padding: 12px 14px; border-bottom: 1px solid rgba(245,241,232,.08); vertical-align: middle; } th { color: var(--muted); text-align: left; font-size: 11px; text-transform: uppercase; letter-spacing: .1em; font-weight: 900; } - td:first-child { font-weight: 800; color: var(--ink); } + td:first-child, th[scope="row"] { font-weight: 800; color: var(--ink); text-align: left; } tr:last-child td { border-bottom: 0; } .y { color: var(--green); font-weight: 900; } .n { color: var(--red); font-weight: 900; } @@ -384,11 +384,11 @@

Sync surface by harness

- - - - - + + + + +
HarnessSkillsAgent rolesMCPHooksRoot instructions
Claude CodeyesyesyesyesCLAUDE.md shim
CodexyesyesyesyesAGENTS.md
Factory DroidyesyesyesyesAGENTS link
Hermesyes--yesyesnative ctx
Piyes--yes--OMP ctx
Claude CodeyesyesyesyesCLAUDE.md shim
CodexyesyesyesyesAGENTS.md
Factory DroidyesyesyesyesAGENTS link
Hermesyes--yesyesnative ctx
Piyes--yes--OMP ctx
@@ -406,14 +406,14 @@

Comparison

- - - - - - - - + + + + + + + +
dotagentsskillsharevsyncagents-cli
Skills syncyesyesyesyes
MCP syncyesnoyesyes
Hooks syncyesnonono
Agent rolesyesnoyesno
Plugin catalogyesnonono
Skill pinningyesyesnono
Security audityesyesnono
Private overlayyesnonono
Skills syncyesyesyesyes
MCP syncyesnoyesyes
Hooks syncyesnonono
Agent rolesyesnoyesno
Plugin catalogyesnonono
Skill pinningyesyesnono
Security audityesyesnono
Private overlayyesnonono