rules SKILL.md skillA

rules from uze-sh/uze is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add uze-sh/uze/rules@git:20261019.4ff171d

Pins git:20261019.4ff171d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
uze-sh/uze
Path
plugins/uze/skills/rules/SKILL.md
Versions recorded
1
Latest version
git:20261019.4ff171d, committed Oct 19, 2026
Size
8,134 bytes
Repository stars
3
License
Apache-2.0

Writing a project's rules, the instructions that apply only when they are relevant, under `.agents/rules/`. Covers deciding whether something is a rule, `AGENTS.md` or a Skill, choosing the trigger, writing patterns in the supported glob dialect, wording a rule as a convention, deciding when a rule belongs in a shared plugin and moving it there, and proving it with `uze agent rules check`. Use when asked to create, add or write a rule, when an instruction "only applies to src/…" or to one kind…

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

# UZE: a project's rules, written once

A rule is a Markdown file directly under `.agents/rules/` in the checkout,
versioned with the project. Its frontmatter says when it applies:

```markdown
---
trigger: glob
globs: "**/src/ui/**/*.rs"
---

Colours come from the theme: name a `Token`, never an RGB value.
```

Antigravity reads `.agents/rules/` itself. Claude Code, Codex and OpenCode
receive the same files through the rules engine `uze setup` installs. Every
harness reads the one directory and the one format, so a rule is written
once.

A subfolder of `.agents/rules/` is read only once `.agents/rules.json`
registers it, the way Antigravity reads it and so UZE and the engine too:

```json
{"entries": [{"path": ".agents/rules/team"}]}
```

`path` is relative to the checkout root, not to the manifest. A folder
entry reads the `*.md` directly in it, a file entry that one file;
`include_only` and `exclude` list paths relative to the entry. A manifest
that does not parse registers nothing, and `inherits` reaches Antigravity
alone. Keep the project's own rules flat unless a folder genuinely helps,
and never add or edit an entry naming a plugin's folder: those are UZE's.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add uze-sh/uze/rules@sha256:c1da36d7c3fe113d

The line at the top of this page pins the label git:20261019.4ff171d, 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_g6kzdpsd67nqtyxr.svg)](https://markdownregistry.com/a/art_g6kzdpsd67nqtyxr)

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

Versions

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

versioncommittedcommitsizeaudit
git:20261019.4ff171d latest2026-10-19 4ff171d 8,134 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8134 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

uze-sh/uze · 3 stars · license Apache-2.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_g6kzdpsd67nqtyxr
GET https://markdownregistry.com/api/v1/resolve?ref=uze-sh/uze/rules
GET https://markdownregistry.com/api/v1/blob/c1da36d7c3fe113d141f9f902026746e72bc1e59a7b1d671c0655b74c6f67bc1

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: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from uze-sh/uze

conformance-debug SKILL.md skill
uze-sh/uze · .agents/skills/conformance-debug/SKILL.md · Fast, targeted debugging of the Harness Conformance Lab (conformance/) — use whenever a conformance check fails…
git:20261017.1d0b3a6 · audit A · 3 stars
design-system SKILL.md skill
uze-sh/uze · .agents/skills/design-system/SKILL.md · The design system for everything UZE draws or prints - the workspace TUI (src/ui/), the CLI's output and help…
git:20261019.4e31f58 · audit A · 3 stars
harness-watch SKILL.md skill
uze-sh/uze · .agents/skills/harness-watch/SKILL.md · Surveying what the supported harnesses (Claude Code, Codex, OpenCode, Antigravity CLI) shipped since UZE last looked…
git:20261014.fd0b4a7 · audit A · 3 stars
journey-author SKILL.md skill
uze-sh/uze · .agents/skills/journey-author/SKILL.md · Writing, changing or debugging a product journey (journeys/) — use whenever you are adding a scenario for a user-facing…
git:20261017.1d0b3a6 · audit A · 3 stars
openspec-apply-change SKILL.md skill
uze-sh/uze · .agents/skills/openspec-apply-change/SKILL.md · Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or…
v1.0 · audit A · 3 stars
openspec-archive-change SKILL.md skill
uze-sh/uze · .agents/skills/openspec-archive-change/SKILL.md · Archive a completed OpenSpec change in the experimental workflow. Use when the user wants to finalize and archive a…
v1.0 · audit A · 3 stars
openspec-explore SKILL.md skill
uze-sh/uze · .agents/skills/openspec-explore/SKILL.md · Enter OpenSpec explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying…
v1.0 · audit A · 3 stars
openspec-propose SKILL.md skill
uze-sh/uze · .agents/skills/openspec-propose/SKILL.md · Propose a new OpenSpec change with all artifacts generated in one step. Use when the user wants to quickly describe…
v1.0 · audit A · 3 stars
openspec-sync-specs SKILL.md skill
uze-sh/uze · .agents/skills/openspec-sync-specs/SKILL.md · Sync delta specs from an OpenSpec change to main specs. Use when the user wants to update main specs with changes from…
v1.0 · audit A · 3 stars
openspec-update-change SKILL.md skill
uze-sh/uze · .agents/skills/openspec-update-change/SKILL.md · Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another. Use…
v1.0 · audit A · 3 stars
AGENTS.md AGENTS.md file
uze-sh/uze · AGENTS.md
git:20261017.1d0b3a6 · audit A · 3 stars
analyze SKILL.md skill
uze-sh/uze · conformance/_fixtures/marketplace/plugins/flow/skills/analyze/SKILL.md · Conformance fixture for a skill unavailable from slash commands.
git:20260906.db42e8c · audit A · 3 stars

Every file in uze-sh/uze

Other files named rules

rules SKILL.md skill
code-yeongyu/oh-my-openagent · packages/omo-codex/plugin/components/rules/skills/rules/SKILL.md · Use when the user asks about Codex Rules behavior, injected project rules, supported rule file locations, matching, or…
git:20260603.44361cf · audit A · 70,277 stars
rules Cursor rule
thedaviddias/llms-txt-hub · .cursor/rules/rules.mdc · Rules for placing and organizing Cursor rule files in the repository.
git:20250224.001a864 · audit A · 914 stars
rules SKILL.md skill
kochetkov-ma/claude-brewcode · .codex/plugins/brewcode/skills/rules/SKILL.md · Maintains project .codex/rules and the AGENTS.md rule index. Explicit user invocation only.
git:20260930.2f50853 · audit A · 37 stars
rules SKILL.md skill
kochetkov-ma/claude-brewcode · brewcode/.codex/skills/rules/SKILL.md · Maintains project .codex/rules and the AGENTS.md rule index. Explicit user invocation only.
git:20260930.2f50853 · audit A · 37 stars
rules SKILL.md skill
kochetkov-ma/claude-brewcode · brewcode/skills/rules/SKILL.md · Syncs KNOWLEDGE.jsonl or session learnings to project rules. Triggers: rules, knowledge sync, extract rules.
git:20261017.43a1a80 · audit A · 37 stars
rules SKILL.md skill
mikeprasad/aria-knowledge · plugin-claude-cowork/skills/rules/SKILL.md · Quick lookup into working rules. Use when user says "/aria-cowork:rules", "/aria-cowork:rules 22", "/aria-cowork:rules…
git:20260827.e9e0353 · audit A · 17 stars
rules SKILL.md skill
mikeprasad/aria-knowledge · plugin-openai-codex/skills/rules/SKILL.md · Load and apply ARIA working rules, user rules, examples, and the change decision framework. Trigger on /rules, show…
git:20260725.82f826d · audit A · 17 stars
rules SKILL.md skill
mikeprasad/aria-knowledge · plugin-antigravity/skills/rules/SKILL.md · Quick lookup into working rules. Use when user says '/rules', '/rules 22', '/rules dependencies', 'look up rule…
git:20260725.82f826d · audit B · 17 stars

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