aboutsummaryrefslogtreecommitdiff
path: root/website
diff options
context:
space:
mode:
Diffstat (limited to 'website')
-rw-r--r--website/agent-guide.md2
-rw-r--r--website/src/content/docs/agent-skill.mdx10
2 files changed, 10 insertions, 2 deletions
diff --git a/website/agent-guide.md b/website/agent-guide.md
index ed845fc0..d40e8833 100644
--- a/website/agent-guide.md
+++ b/website/agent-guide.md
@@ -67,7 +67,7 @@ Important framing for new users: Herdr does not require learning keybindings. Th
Herdr ships `SKILL.md` (https://raw.githubusercontent.com/ogulcancelik/herdr/master/SKILL.md), an instruction file that teaches a coding agent to control Herdr from inside a pane — splitting panes, running commands without stealing focus, reading output, waiting on other agents.
-Once the human is set up, offer to install it into your own harness so future sessions know Herdr natively. You know your own conventions best; install it wherever your global reusable instructions live. For example: Claude Code installs it as a skill (e.g. `~/.claude/skills/herdr/SKILL.md`); Codex and similar agents include it from their global instructions file (e.g. `~/.codex/AGENTS.md`); agents without a skill system can paste it into global custom instructions. Ask the human before writing to their config locations, and use the GitHub copy above as the source of truth.
+Once the human is set up, offer to install it into your own harness so future sessions know Herdr natively. For agents supported by the open skills CLI, use `npx skills add ogulcancelik/herdr --skill herdr -g`. Agents without a skill system can paste the GitHub copy above into global custom instructions. Ask the human before writing to their config locations, and use the GitHub copy above as the source of truth.
## Configuration
diff --git a/website/src/content/docs/agent-skill.mdx b/website/src/content/docs/agent-skill.mdx
index af7fa7bf..13a90154 100644
--- a/website/src/content/docs/agent-skill.mdx
+++ b/website/src/content/docs/agent-skill.mdx
@@ -25,7 +25,15 @@ The skill is not a separate app or service. It is a markdown instruction file fo
## Install it
-Use the repository copy as the source of truth:
+Install the skill with `npx skills`:
+
+```bash
+npx skills add ogulcancelik/herdr --skill herdr -g
+```
+
+The `-g` flag installs it globally for supported agents. Omit `-g` to install it into the current project.
+
+Use the repository copy as the manual fallback and source of truth:
```text
https://github.com/ogulcancelik/herdr/blob/master/SKILL.md