Home / horace-maxwell / horosa-skill · GitHub

AGENTS.mdB

AGENTS.md from horace-maxwell/horosa-skill is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add horace-maxwell/horosa-skill/AGENTS.md@git:20261105.dbdf8c5

Pins git:20261105.dbdf8c5 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
horace-maxwell/horosa-skill
Path
AGENTS.md
Versions recorded
63
Latest version
git:20261105.dbdf8c5, committed Nov 5, 2026
First version recorded
Sep 11, 2026
Size
213,860 bytes
Repository stars
497
License
AGPL-3.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Horosa Skill — Agent Rules

These rules are for every agent connected to this repository or its MCP server — Claude Code / Claude Desktop, Codex,
Cursor, VS Code, Zed, Gemini CLI, Devin Desktop (ex-Windsurf), Cline, OpenClaw, Open WebUI … (the current client matrix
lives in README「接入 AI 客户端」; do not re-list it here).

**本文件只记「现行真相」（current truth），按主题组织。** 逐版本教训原文在
[`docs/LESSONS.md`](./docs/LESSONS.md)（只增台账）；领域名词在 [`docs/GLOSSARY.md`](./docs/GLOSSARY.md)；
Claude Code 的薄入口是根 [`CLAUDE.md`](./CLAUDE.md)（与本文 §0 路由一致）。

目录：§0 定向路由 · §1 铁律 · §2 🔴问题记录协议 v3 · §3 AI 客户端行为（指针） · §4 计算模型 ·
§5 新增技法/re-vendor · §6 打包不变量 · §7 发布协议 · §8 本地验证与症状速查 · §9 Stability invariants ·
§10 上游镜像注记 · §11 MIT 义务 · §12 经验台账

---

## 0. 30 秒定向与路由

Horosa Skill 把星阙（Horosa）的 **114 个**术数/占星技法打包成 local-first 的 **MCP server + CLI**：
算法跑在本机离线 runtime（Java 聚合层 `:9999` + Python chart 服务 `:8899`（含 ken/kentang 引擎）+
bundled Node headless 引擎 `horosa-core-js`），每个技法输出统一 envelope + 星阙式
`export_snapshot`/`export_format`；仓库保持轻量，重 runtime 走 GitHub Releases 分发。
本仓是星阙的**下游**（sync 方向：星阙 → skill，永不反向）。

| 你要做什么 | 去哪里 |
| --- | --- |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add horace-maxwell/horosa-skill/AGENTS.md@sha256:01c3a42bb5f353d9

The line at the top of this page pins the label git:20261105.dbdf8c5, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_xszzvmfcvknyomk7.svg)](https://markdownregistry.com/a/art_xszzvmfcvknyomk7)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 63 versions of this file, between Sep 11, 2026 and Nov 5, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261105.dbdf8c5 latest2026-11-05 dbdf8c5 213,860 BB view · diff
git:20261105.8df42d02026-11-05 8df42d0 213,684 BB view · diff
git:20261104.aa8df2d2026-11-04 aa8df2d 210,495 BB view · diff
git:20261104.eff169d2026-11-04 eff169d 210,185 BB view · diff
git:20261104.a9182902026-11-04 a918290 209,679 BB view · diff
git:20261031.ce7eb522026-10-31 ce7eb52 204,593 BB view · diff
git:20261030.f7cc26b2026-10-30 f7cc26b 204,044 BB view · diff
git:20261030.9d87c8e2026-10-30 9d87c8e 203,863 BB view · diff
git:20261030.7e81ee02026-10-30 7e81ee0 203,384 BB view · diff
git:20261030.8ac208c2026-10-30 8ac208c 203,099 BB view · diff
git:20261028.7c80a212026-10-28 7c80a21 199,952 BA view · diff
git:20261028.ffb52202026-10-28 ffb5220 199,629 BA view · diff
git:20261028.3dc1b612026-10-28 3dc1b61 199,462 BA view · diff
git:20261028.100d0f62026-10-28 100d0f6 198,677 BA view · diff
git:20261028.4f1209d2026-10-28 4f1209d 197,713 BA view · diff
git:20261024.87e4ef12026-10-24 87e4ef1 192,647 BA view · diff
git:20261024.20c54be2026-10-24 20c54be 192,461 BA view · diff
git:20261024.3ade9292026-10-24 3ade929 188,104 BA view · diff
git:20261024.4c0626a2026-10-24 4c0626a 186,793 BA view · diff
git:20261023.7e3fe9e2026-10-23 7e3fe9e 184,035 BA view · diff
git:20261021.c74fdaa2026-10-21 c74fdaa 176,714 BA view · diff
git:20261021.fe7104d2026-10-21 fe7104d 176,368 BA view · diff
git:20261020.e1fda992026-10-20 e1fda99 175,132 BA view · diff
git:20261020.5b3a2b02026-10-20 5b3a2b0 173,850 BA view · diff
git:20261020.76b9ceb2026-10-20 76b9ceb 173,394 BA view · diff
git:20261012.03924ae2026-10-12 03924ae 168,623 BA view · diff
git:20261012.90c48f82026-10-12 90c48f8 168,371 BA view · diff
git:20261012.fc2ec4f2026-10-12 fc2ec4f 164,542 BA view · diff
git:20261012.3fdda642026-10-12 3fdda64 164,546 BA view · diff
git:20261006.7ba3ab62026-10-06 7ba3ab6 162,829 BA view · diff
git:20261006.d14203a2026-10-06 d14203a 162,120 BA view · diff
git:20261006.99a3bd92026-10-06 99a3bd9 161,982 BA view · diff
git:20261001.cb741a32026-10-01 cb741a3 161,726 BA view · diff
git:20261001.f3f4c592026-10-01 f3f4c59 160,311 BA view · diff
git:20261001.b3949b72026-10-01 b3949b7 159,796 BA view · diff
git:20261001.2086b9f2026-10-01 2086b9f 159,132 BA view · diff
git:20261001.ff411462026-10-01 ff41146 157,929 BA view · diff
git:20260929.f2b720a2026-09-29 f2b720a 151,977 BA view · diff
git:20260929.d632d302026-09-29 d632d30 145,608 BA view · diff
git:20260925.7cde5192026-09-25 7cde519 140,290 BA view · diff
git:20260924.f05f7272026-09-24 f05f727 139,068 BA view · diff
git:20260924.e2118a82026-09-24 e2118a8 138,871 BA view · diff
git:20260924.5f5ffa92026-09-24 5f5ffa9 138,535 BA view · diff
git:20260924.efc41152026-09-24 efc4115 138,140 BA view · diff
git:20260922.86e00c72026-09-22 86e00c7 130,760 BA view · diff
git:20260922.350324d2026-09-22 350324d 128,435 BA view · diff
git:20260922.3a5235e2026-09-22 3a5235e 127,182 BA view · diff
git:20260922.f3985662026-09-22 f398566 128,121 BA view · diff
git:20260915.2e6db9c2026-09-15 2e6db9c 125,441 BA view · diff
git:20260915.5fd975a2026-09-15 5fd975a 124,356 BA view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: Size between 200 bytes and 200 KB (213860 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for AGENTS.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

horace-maxwell/horosa-skill · 497 stars · license AGPL-3.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xszzvmfcvknyomk7
GET https://markdownregistry.com/api/v1/resolve?ref=horace-maxwell/horosa-skill/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/01c3a42bb5f353d95f9f5f8f80a8b126e49527b4c4148dd42f96a3da812c00dc

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from horace-maxwell/horosa-skill

horosa-agent SKILL.md skill
horace-maxwell/horosa-skill · .agents/skills/horosa-agent/SKILL.md · Use Horosa (星阙) local metaphysics MCP tools correctly — 114 techniques: Western astrology natal chart, solar return…
git:20261030.76d0202 · audit A · 497 stars
horosa-skill Cursor rule
horace-maxwell/horosa-skill · .cursor/rules/horosa-skill.mdc · Horosa Skill MCP usage rules for Cursor agents
git:20260914.9bd7f1f · audit A · 497 stars
CLAUDE.md CLAUDE.md file
horace-maxwell/horosa-skill · CLAUDE.md
git:20261030.76d0202 · audit A · 497 stars
horosa-agent SKILL.md skill
horace-maxwell/horosa-skill · horosa-skill/src/horosa_skill/agent_skill/horosa-agent/SKILL.md · Call Horosa (星阙) local metaphysics tools correctly over MCP or CLI — 114 real techniques: Western natal/predictive…
v0.47.1 · audit B · 497 stars
horosa-agent SKILL.md skill
horace-maxwell/horosa-skill · skills/horosa-agent/SKILL.md · Call Horosa (星阙) local metaphysics tools correctly over MCP or CLI — 114 real techniques: Western natal/predictive…
v0.47.1 · audit B · 497 stars

Every file in horace-maxwell/horosa-skill

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade B, or by owner.