docs: add a written bar for host guides and an other-hosts page

The README install section now lists only hosts a maintainer has run.
Every other host gets one line in docs/other-hosts.md, with no setup
page, vendor links or branding, and host guides are reviewed in the
order they were opened. Oh My Pi moves there.
This commit is contained in:
Addy Osmani committed 2026-10-03 11:20:54 -07:00
1 parent 23a777adda
commit 8f1886ef00
3 files changed
+16 -1

No files matched your search

+8
View File
@@ -72,6 +72,14 @@ Before proposing a change, search the [skill-change rejection ledger](evals/skil
If a skill or description change is rejected based on eval results, add one row to the ledger with the date, affected skill, concise attempted change, before-to-after rank-1 score, and rejected PR link and outcome. Land that ledger-only update separately on the default branch; do not leave it only on the rejected proposal branch, where closing or force-pushing the proposal could discard the record.
## Adding a Host Guide
The README install section lists only hosts a maintainer has installed and run the current release on. Every other host gets one line in [docs/other-hosts.md](docs/other-hosts.md): the host name and its install command. No dedicated setup page, vendor links, logos, emoji, or screenshots.
- If you work for the company behind the host, say so in the PR.
- A host moves into the README once a maintainer has run it and is willing to keep its entry current.
- Host guides are reviewed in the order they were opened.
## Repo-scoped files
`AGENTS.md` and `CLAUDE.md` at the repo root configure agents working on the [`addyosmani/agent-skills`](https://github.com/addyosmani/agent-skills) repository itself. When writing setup guides or docs, do not instruct users to copy these files into their own projects or into a global agent configuration; the reusable assets are the skills in `skills/`.
+1 -1
View File
@@ -205,7 +205,7 @@ Installed skills show up in the TUI slash menu, e.g. `/spec-driven-development`.
<details>
<summary><b>Other Agents</b></summary>
Skills are plain Markdown - they work with any agent that accepts system prompts or instruction files. See [docs/getting-started.md](docs/getting-started.md).
Skills are plain Markdown - they work with any agent that accepts system prompts or instruction files. See [docs/getting-started.md](docs/getting-started.md). Hosts that install the pack but aren't listed above are in [docs/other-hosts.md](docs/other-hosts.md).
</details>
+7
View File
@@ -0,0 +1,7 @@
# Other hosts
These hosts install the pack but are not in the README's install section, because no maintainer has run the current release on them. Each entry is one line: the host and its install command. To add one, see [Adding a Host Guide](../CONTRIBUTING.md#adding-a-host-guide).
Skills are plain `SKILL.md` folders, so any agent that reads the Agent Skills layout can load them. See [getting-started.md](getting-started.md).
- **Oh My Pi**: `omp plugin marketplace add addyosmani/agent-skills`, then `omp plugin install agent-skills@addy-agent-skills`