Home / reidemeister94 / development-skills · skills/best-practices/SKILL.md · GitHub

best-practices skillA

best-practices is agent-read markdown (skill) from reidemeister94/development-skills: Research current practices or compare approaches using primary evidence and the user's constraints..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Best practices

Research the requested topic with current, high-quality evidence and first-principles reasoning.
Keep research artifacts outside the repository unless the result remains useful after the task.
If a subagent performs the research, give the main agent the artifact paths.

For technical topics, prefer primary and authoritative sources:

- official documentation and specifications;
- maintainer posts, authoritative engineering blogs, and peer-reviewed papers;
- widely adopted open-source projects that are actively maintained.

Age each claim against its own horizon.
Versions, APIs, pricing, limits, and advisories can change within weeks.
Tool choices can change within months. Architecture and patterns can remain valid for years.
Explain why an older source still applies and check whether a newer source replaced it.
Mark facts that you cannot confirm as unverified.

Cite material claims inline and separate evidence from inference.
Explain consensus, disagreement, uncertainty, and where each recommendation applies.
State what evidence would overturn the recommendation.
Recommend for the user's goals and constraints, not for an imaginary average user.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add reidemeister94/development-skills/best-practices@git:20260919.a9f7da5
Exact content
mdr add reidemeister94/development-skills/best-practices@sha256:f7a936a447e36d03

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260919.a9f7da5 latest2026-09-19 a9f7da5 1,614 BA view · diff
git:20260724.ba2c70f2026-07-24 ba2c70f 1,036 BA view · diff
git:20260713.d2107012026-07-13 d210701 1,143 BA view · diff
git:20260617.174aad82026-06-17 174aad8 2,886 BA view · diff
git:20260615.b23d57a2026-06-15 b23d57a 18,199 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (1614 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

reidemeister94/development-skills · 12 stars · license MIT · pushed 2026-09-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bm5hf7uatmdfumvc
GET https://markdownregistry.com/api/v1/resolve?ref=reidemeister94/development-skills/best-practices
GET https://markdownregistry.com/api/v1/blob/f7a936a447e36d03a92e868e068c6e5fe2d1e77fde825c41e105f3a4d7500e78

Your agent 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.

More from reidemeister94/development-skills

AGENTS.md agents
reidemeister94/development-skills · AGENTS.md
git:20260919.a9f7da5 · audit A · 12 stars
CLAUDE.md claude
reidemeister94/development-skills · CLAUDE.md
git:20260517.21d6bf8 · audit B · 12 stars
ai-agent-bench skill
reidemeister94/development-skills · skills/ai-agent-bench/SKILL.md · Compare Claude Code and Codex on the same code task, with isolated worktrees, common checks, time, and cost.
git:20260919.a9f7da5 · audit A · 12 stars
align-docs skill
reidemeister94/development-skills · skills/align-docs/SKILL.md · Align stale repository docs and task records; use --clean for a full documentation cleanup.
git:20260919.a9f7da5 · audit A · 12 stars
brainstorming skill
reidemeister94/development-skills · skills/brainstorming/SKILL.md · Use when the user wants to brainstorm, choose an approach, design something, or clarify an ambiguous or consequential…
git:20260919.a9f7da5 · audit A · 12 stars
bro skill
reidemeister94/development-skills · skills/bro/SKILL.md · Use when the user says an explanation was unclear, too technical, or full of jargon, or asks for plain language.
git:20260919.a9f7da5 · audit A · 12 stars
changelog skill
reidemeister94/development-skills · skills/changelog/SKILL.md · Add CHANGELOG.md entries, derive them from commits, or cut a Keep a Changelog and SemVer release.
git:20260724.ba2c70f · audit A · 12 stars
commit skill
reidemeister94/development-skills · skills/commit/SKILL.md · Create a user-requested Conventional Commit from the staged changes.
git:20260919.a9f7da5 · audit A · 12 stars
create-test skill
reidemeister94/development-skills · skills/create-test/SKILL.md · Define or implement regression proof: test strategy, black-box or integration tests, KPIs, thresholds, audits, or…
git:20260919.a9f7da5 · audit A · 12 stars
eval-regression skill
reidemeister94/development-skills · skills/eval-regression/SKILL.md · Check skill routing or behavior, investigate a regression, or compare plugin changes with a base commit.
git:20260919.a9f7da5 · audit A · 12 stars
explain-diff skill
reidemeister94/development-skills · skills/explain-diff/SKILL.md · Explain a code change, its reasons, effects, trade-offs, and verification limits.
git:20260919.a9f7da5 · audit A · 12 stars
handoff skill
reidemeister94/development-skills · skills/handoff/SKILL.md · Create a self-contained temporary handoff document when the user asks to transfer the session to a new chat or runs…
git:20260919.a9f7da5 · audit A · 12 stars

Every file in reidemeister94/development-skills

Other files named best-practices

best-practices skill
sd0xdev/sd0x-harness · skills/best-practices/SKILL.md · Industry best practices conformance audit with mandatory adversarial debate. Produces audit artifact: verdict…
git:20260905.3d84d94 · audit A · 189 stars
best-practices skill
vinta/hal-9000 · skills/best-practices/SKILL.md · Use when about to choose, configure, or refine a tool, library, config format, API pattern, or project setup, or before…
git:20260923.16c363b · audit A · 138 stars
best-practices skill
cooneycw/claude-power-pack · .claude/skills/best-practices/SKILL.md · Routes to topic-specific best practices skills instead of loading them all. Use for Claude Code help, tips, or a how to…
git:20260920.677b300 · audit A · 19 stars

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