AGENTS.mdA

AGENTS.md from kirinlin/tw-writing is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add kirinlin/tw-writing/AGENTS.md@git:20260919.e8302a4

Pins git:20260919.e8302a4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
kirinlin/tw-writing
Path
AGENTS.md
Versions recorded
1
Latest version
git:20260919.e8302a4, committed Sep 19, 2026
Size
3,629 bytes
Repository stars
17
License
MIT

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

# AGENTS.md

本檔案提供 AI Agent 在此 repository 工作時所需的共用指引。

## 專案性質

本 repo 是一個 Agent Skill,內容全為 Markdown 文件,沒有程式碼、建置流程或測試。`SKILL.md` 就是產品本身;`README.md`、`CHANGELOG.md` 是它的附屬說明。同一份 `SKILL.md` 可安裝到多種支援 Skill 的 Agent。

本 repo 支援下列安裝管道,且都要求 `SKILL.md` 位於 repo 根目錄:

1. **手動 clone** 到 Agent 的 skills 目錄。
2. **`npx skills add kirinlin/tw-writing`**([vercel-labs/skills](https://github.com/vercel-labs/skills)):Codex、Claude Code、opencode、Cursor 等支援 Skill 的 Agent 皆可安裝,其掃描規則會在 repo 根目錄尋找 `SKILL.md`。
3. **Claude Code Plugin Marketplace**:Claude Code 專用的安裝管道,細節請見 `CLAUDE.md`。

因此,**絕對不要**把 `SKILL.md` 移到 `skills/tw-writing/SKILL.md` 之類的子目錄。這會讓手動安裝與 `npx skills add` 失效。

## 檔案角色

- `SKILL.md` — 台灣繁體中文寫作規範全文,共 29 節。開頭的 YAML frontmatter(`name`、`description`)決定 Agent 何時自動載入本 Skill;修改 `description` 會改變觸發行為。`name` 必須與安裝目錄名稱一致。
- `references/taiwan-terms.md` — 台灣用語與中國用語完整對照表。此檔案刻意放在 `references/`,而非 `SKILL.md` 內。這是 progressive disclosure:Agent 僅在需要時載入長尾查表資料,避免每次都占用 context。高頻詞與同形異義詞保留在 `SKILL.md` §11,因為這些內容容易出錯,而且必須隨時可用。
- `README.md` — 面向 repo 讀者的摘要與安裝說明,內容衍生自 `SKILL.md`。
- `CHANGELOG.md` — 遵循 [Keep a Changelog](https://keepachangelog.com/) 格式。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kirinlin/tw-writing/AGENTS.md@sha256:726c15d59946653a

The line at the top of this page pins the label git:20260919.e8302a4, 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_hycuvamituwrejyi.svg)](https://markdownregistry.com/a/art_hycuvamituwrejyi)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 19, 2026.

versioncommittedcommitsizeaudit
git:20260919.e8302a4 latest2026-09-19 e8302a4 3,629 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (3629 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

Source

GitHub

kirinlin/tw-writing · 17 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hycuvamituwrejyi
GET https://markdownregistry.com/api/v1/resolve?ref=kirinlin/tw-writing/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/726c15d59946653a4d23b53542ce5107f8220424c5d1125b5422ee6dadafc214

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 kirinlin/tw-writing

CLAUDE.md CLAUDE.md file
kirinlin/tw-writing · CLAUDE.md
git:20260919.e8302a4 · audit A · 17 stars
tw-writing SKILL.md skill
kirinlin/tw-writing · SKILL.md · 撰寫、改寫、審查、潤稿或翻譯台灣繁體中文內容時使用,尤其適用於技術文件、 README、規格書、操作說明、錯誤訊息與 PR 描述。改善結構、語意、台灣用語、 中英文混排與標點,同時保留原文事實、技術識別名稱及規範強度。
git:20261107.4aca44f · audit A · 17 stars

Every file in kirinlin/tw-writing

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 A, or by owner.