AGENTS.mdB

AGENTS.md from dongshuyan/compass-skills is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add dongshuyan/compass-skills/AGENTS.md@git:20261019.5bf1e5d

Pins git:20261019.5bf1e5d in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
dongshuyan/compass-skills
Path
AGENTS.md
Versions recorded
5
Latest version
git:20261019.5bf1e5d, committed Oct 19, 2026
First version recorded
Jun 19, 2026
Size
4,600 bytes
Repository stars
758
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

# COMPASS Agent Adapter

This repository contains agent-agnostic `SKILL.md` skills. Use this file when your agent does not have native skills support, or when it needs explicit rules for discovering and applying the skills in `skills/`.

## Discovery

- Available skills live under `skills/<skill-name>/SKILL.md`.
- Read each skill's YAML frontmatter `name` and `description` to decide whether it applies.
- Prefer explicit user invocation such as `$task-clarifier`, `$task-forest`, `$pause-and-resume`, `$session-handoff-prompt`, `$user-profile-keeper`, `$run-history-skill-builder`, `$run-history-skill-upgrader`, `$clear-communication`, or `$assess-interview-candidate`.
- If no skill clearly applies, continue normally; do not force a skill.

## Loading Protocol

When a skill applies:

1. Read the full `SKILL.md` before acting.
2. Resolve relative paths from the directory that contains that `SKILL.md`.
3. Read referenced files under `references/` only when the skill tells you to or when the current task needs them.
4. Run scripts from the skill's own `scripts/` directory instead of retyping large logic.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dongshuyan/compass-skills/AGENTS.md@sha256:a8909edfa28eb510

The line at the top of this page pins the label git:20261019.5bf1e5d, 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_dnmlpxeuh4rxvm3o.svg)](https://markdownregistry.com/a/art_dnmlpxeuh4rxvm3o)

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

Versions

The registry has recorded 5 versions of this file, between Jun 19, 2026 and Oct 19, 2026, about one every 30 days.

versioncommittedcommitsizeaudit
git:20261019.5bf1e5d latest2026-10-19 5bf1e5d 4,600 BB view · diff
git:20260826.2cd09f22026-08-26 2cd09f2 4,215 BB view · diff
git:20260823.bd252ef2026-08-23 bd252ef 3,962 BB view · diff
git:20260708.508fc372026-07-08 508fc37 3,318 BB view · diff
git:20260619.64307f32026-06-19 64307f3 2,855 BB 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: No instruction to read or print local credentials (matched: read password managers, keychain)
  • pass: Size between 200 bytes and 200 KB (4600 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 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

dongshuyan/compass-skills · 758 stars · license MIT · pushed 2026-10-19 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_dnmlpxeuh4rxvm3o
GET https://markdownregistry.com/api/v1/resolve?ref=dongshuyan/compass-skills/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/a8909edfa28eb510d973e166f1d281a5fb9ea5a0110fdf32c9829a69459865c6

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 dongshuyan/compass-skills

academic-humanizer SKILL.md skill
dongshuyan/compass-skills · skills/academic-humanizer/SKILL.md · Draft, audit, or minimally revise English- or Chinese-language academic prose to reduce formulaic, vacuous…
git:20260711.47b0dab · audit A · 758 stars
assess-interview-candidate SKILL.md skill
dongshuyan/compass-skills · skills/assess-interview-candidate/SKILL.md · 根据候选人简历与岗位要求生成可审计的后台评估、简明的候选人介绍、按岗位重要性排列的简历疑点、12–18 道可直接照读的面试题,以及支持重点标记和本机保存的离线…
git:20261019.39f769b · audit A · 758 stars
clear-communication SKILL.md skill
dongshuyan/compass-skills · skills/clear-communication/SKILL.md · 面向读者组织准确、易理解的解释、状态汇报、方案比较和文档;用于复杂概念说明、长文、重要条件的表达或保持原意的改写。适用于中英文,可与学术及其他领域写作规则组合使用。
git:20261019.5bf1e5d · audit A · 758 stars
pause-and-resume SKILL.md skill
dongshuyan/compass-skills · skills/pause-and-resume/SKILL.md · Cooperatively pause unfinished work in the current session, leave a precise continuation checkpoint, and resume from it…
git:20260826.2cd09f2 · audit A · 758 stars
run-history-skill-builder SKILL.md skill
dongshuyan/compass-skills · skills/run-history-skill-builder/SKILL.md · Turn a completed task, browser flow, artifact pipeline, failure-recovery trace, or repeatedly refined workflow into a…
git:20260826.1b2e556 · audit A · 758 stars
run-history-skill-upgrader SKILL.md skill
dongshuyan/compass-skills · skills/run-history-skill-upgrader/SKILL.md · Use real run evidence, validation failures, source drift, platform drift, and user feedback to plan and, only after…
git:20260826.1b2e556 · audit A · 758 stars
session-handoff-prompt SKILL.md skill
dongshuyan/compass-skills · skills/session-handoff-prompt/SKILL.md · Create a concise continuation prompt that a fresh agent session can paste in to resume a long or degraded session. Use…
git:20260826.1b2e556 · audit A · 758 stars
task-clarifier SKILL.md skill
dongshuyan/compass-skills · skills/task-clarifier/SKILL.md · Deep need-clarification skill. Use only when the user explicitly invokes $task-clarifier. Once activated, keep asking…
git:20260826.1b2e556 · audit A · 758 stars
task-forest SKILL.md skill
dongshuyan/compass-skills · skills/task-forest/SKILL.md · Maintains a repo-local task forest or task DAG for the current workspace. Use when the user asks to initialize or…
git:20260826.1b2e556 · audit A · 758 stars
user-profile-keeper SKILL.md skill
dongshuyan/compass-skills · skills/user-profile-keeper/SKILL.md · Local user-profile maintenance skill for Codex, Claude Code, OpenClaw, OpenCode, and other agent harnesses. Use only…
git:20260826.1b2e556 · audit A · 758 stars

Every file in dongshuyan/compass-skills

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

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