hr-navigation-retro SKILL.md skillA

hr-navigation-retro from bompus/house-rules is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bompus/house-rules/hr-navigation-retro@git:20261026.a93a61f

Pins git:20261026.a93a61f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bompus/house-rules
Path
skills/hr-navigation-retro/SKILL.md
Versions recorded
5
Latest version
git:20261026.a93a61f, committed Oct 26, 2026
First version recorded
Oct 7, 2026
Size
4,727 bytes
Repository stars
3
License
MIT

Audit agent navigation using selected tool-call transcripts: rank misses, widened searches, re-reads and stale-doc remarks, verify findings against current repositories, and propose findability fixes. Use when asked to run a navigation retro or to re-measure navigation fixes on named transcripts; general project retrospectives and ordinary conversation are outside this scope.

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

# Navigation retro

Any coding agent with file and shell access can run this workflow. Find
navigation failures in recorded tool-call evidence, then verify their causes
against current source. Ordinary guidance audits belong to
`hr-agent-guidance-audit`. Changes need their existing implementation authority;
a request for a retrospective alone authorizes the investigation and proposals.

## Select evidence

1. Read each target repository's guidance and its restrictions on access.
2. Locate transcripts through the host's existing tools. Select only authorized
   input files; do not scan every account or transcript store to find them. The
   request or schedule that invoked the skill supplies that list. If it names
   none, stop and ask.
3. Record the repository roots used in those sessions, including each checkout
   when the same repository appears at several paths. Map each to one name.
4. Keep transcripts, timelines, metric JSON and reports local. They expose raw
   prompts, commands, assistant text and paths. Truncation is not redaction.

The bundled [parser](scripts/retro.py) requires Python 3.11 or newer and uses only
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bompus/house-rules/hr-navigation-retro@sha256:412800e41c6f8748

The line at the top of this page pins the label git:20261026.a93a61f, 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_zd2wvntezjk6eep3.svg)](https://markdownregistry.com/a/art_zd2wvntezjk6eep3)

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

Versions

The registry has recorded 5 versions of this file, between Oct 7, 2026 and Oct 26, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261026.a93a61f latest2026-10-26 a93a61f 4,727 BA view · diff
git:20261019.4e054652026-10-19 4e05465 4,721 BA view · diff
git:20261007.04fb2e22026-10-07 04fb2e2 4,598 BA view · diff
git:20261007.b9ef1182026-10-07 b9ef118 4,443 BA view · diff
git:20261007.226748b2026-10-07 226748b 4,039 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 (4727 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

bompus/house-rules · 3 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zd2wvntezjk6eep3
GET https://markdownregistry.com/api/v1/resolve?ref=bompus/house-rules/hr-navigation-retro
GET https://markdownregistry.com/api/v1/blob/412800e41c6f8748af128fdfb4d518ba05e727d34bdffd8244e965d538d0f383

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 bompus/house-rules

AGENTS.md AGENTS.md file
bompus/house-rules · AGENTS.md
git:20261101.33e1213 · audit A · 3 stars
AGENTS.md@examples/project AGENTS.md file
bompus/house-rules · examples/project/AGENTS.md
git:20261003.bcf970e · audit A · 3 stars
hr-agent-guidance-audit SKILL.md skill
bompus/house-rules · skills/hr-agent-guidance-audit/SKILL.md · Audit and simplify agent-facing rules, skills and linked docs within the requested repository scope. Use for guidance…
git:20261013.dac23a8 · audit A · 3 stars
hr-agent-guidance-refresh SKILL.md skill
bompus/house-rules · skills/hr-agent-guidance-refresh/SKILL.md · Reread the agent guidance a session loaded (instruction files, skills and subagent definitions) and report what changed…
git:20261012.4d7e92b · audit A · 3 stars
hr-api-exposure-check SKILL.md skill
bompus/house-rules · skills/hr-api-exposure-check/SKILL.md · Keep API responses to the fields a real consumer reads and the caller is allowed to read. Use when designing, changing…
git:20261007.be080b1 · audit A · 3 stars
hr-audit-choices SKILL.md skill
bompus/house-rules · skills/hr-audit-choices/SKILL.md · Audit the decisions an implementing agent made for the user, not its diff: trace the work into a choices ledger with a…
git:20261019.be21b82 · audit A · 3 stars
hr-benchmarking SKILL.md skill
bompus/house-rules · skills/hr-benchmarking/SKILL.md · Benchmark equivalent work with repeated timing, CPU and memory measurements under stated inputs and controls, and check…
git:20261102.a032362 · audit A · 3 stars
hr-better-accessibility SKILL.md skill
bompus/house-rules · skills/hr-better-accessibility/SKILL.md · Accessibility rules for web UI: native elements, keyboard and focus, form labels and errors, accessible names, live…
git:20261018.d9ae3a7 · audit A · 3 stars
hr-better-colors SKILL.md skill
bompus/house-rules · skills/hr-better-colors/SKILL.md · Color rules for web UI: palette ramps, semantic color tokens, color notation and gamut, and measured contrast of…
git:20261008.2645dd1 · audit A · 3 stars
hr-better-layout SKILL.md skill
bompus/house-rules · skills/hr-better-layout/SKILL.md · Layout rules for web UI: grouping, alignment, spacing, reading order, responsive breakpoints, logical properties and…
git:20261008.2645dd1 · audit A · 3 stars
hr-better-typography SKILL.md skill
bompus/house-rules · skills/hr-better-typography/SKILL.md · Typography rules for web UI: type scale, line-height, wrapping, truncation, tabular numbers, font loading and mobile…
git:20261008.2645dd1 · audit A · 3 stars
hr-better-writing SKILL.md skill
bompus/house-rules · skills/hr-better-writing/SKILL.md · Interface copy rules: button and link labels, error messages, empty states, placeholders, toggles and consistent…
git:20261008.2645dd1 · audit A · 3 stars

Every file in bompus/house-rules

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