superior-docs SKILL.md skillA

superior-docs from kodekateam/superior-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kodekateam/superior-skills/superior-docs@git:20261026.bc705e7

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

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kodekateam/superior-skills
Path
skills/superior-docs/SKILL.md
Versions recorded
3
Latest version
git:20261026.bc705e7, committed Oct 26, 2026
First version recorded
Oct 15, 2026
Size
7,737 bytes
Repository stars
47
License
MIT

Create, reconstruct, synchronize, or automatically record durable repository documentation and curated implementation memory from current code, configuration, tests, accepted user intent, existing docs, and Git history. Use for project context, architecture, decisions, implementation change records, timelines, build and distribution guides, maintenance handoffs, or cross-session continuity. After verified material implementation work, record the outcome by default unless the user explicitly…

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

# Superior Docs

Build documentation that lets a future maintainer recover the project's current shape, important decisions, and safe operating procedures without relying on chat history. Documentation is a maintained view of evidence, not a second source of invented truth.

## Select the mode

- **Bootstrap:** establish a useful `docs/` system where none exists.
- **Record:** capture a verified implementation, fix, refactor, configuration change, or feature outcome in the implementation timeline.
- **Memory:** curate accepted intent, criteria, decisions, and maintenance knowledge into the existing timeline, implementation guide, or decisions ledger.
- **Synchronize:** update affected documents after verified project changes.
- **Reconstruct:** derive architectural evolution, releases, or maintenance history from repository evidence.
- **Handoff:** capture the current implementation, boundaries, risks, and next work at the end of a substantial effort.

Do not ask the user to choose when the request already determines the mode.

## Record implementation work by default
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kodekateam/superior-skills/superior-docs@sha256:f58403686fae1939

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

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

Versions

The registry has recorded 3 versions of this file, between Oct 15, 2026 and Oct 26, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261026.bc705e7 latest2026-10-26 bc705e7 7,737 BA view · diff
git:20261015.f73f3832026-10-15 f73f383 7,135 BA view · diff
git:20261015.e3d1e5f2026-10-15 e3d1e5f 6,501 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 (7737 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

kodekateam/superior-skills · 47 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6jrbh2f5ipdedaku
GET https://markdownregistry.com/api/v1/resolve?ref=kodekateam/superior-skills/superior-docs
GET https://markdownregistry.com/api/v1/blob/f58403686fae19394729570b153c37e44999750d46bd199a0b4dd912479fc041

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 kodekateam/superior-skills

AGENTS.md AGENTS.md file
kodekateam/superior-skills · AGENTS.md
git:20261106.9769969 · audit A · 47 stars
superior-accessibility SKILL.md skill
kodekateam/superior-skills · skills/superior-accessibility/SKILL.md · Review or implement interface accessibility for semantics, keyboard operation, focus, contrast, status communication…
git:20261015.f73f383 · audit A · 47 stars
superior-api-security SKILL.md skill
kodekateam/superior-skills · skills/superior-api-security/SKILL.md · Implement, harden, or review defensive security controls for REST APIs, including authentication and authorization…
git:20261015.f413813 · audit A · 47 stars
superior-architecture SKILL.md skill
kodekateam/superior-skills · skills/superior-architecture/SKILL.md · Design, implement, or assess project structure, module ownership, dependency boundaries, and safe file or folder…
git:20261029.325740f · audit A · 47 stars
superior-code-review SKILL.md skill
kodekateam/superior-skills · skills/superior-code-review/SKILL.md · Review a code change, diff, commit, branch, or pull request for actionable defects, regressions, security risks…
git:20261025.89211a9 · audit A · 47 stars
superior-comments SKILL.md skill
kodekateam/superior-skills · skills/superior-comments/SKILL.md · Add, revise, or remove source-code comments while preserving executable behavior. Use for comment-only cleanup…
git:20261015.e3d1e5f · audit A · 47 stars
superior-copywriting SKILL.md skill
kodekateam/superior-skills · skills/superior-copywriting/SKILL.md · Write or revise user-facing product and marketing copy with a specific voice, verifiable claims, natural rhythm, and…
git:20261106.5be7d1d · audit A · 47 stars
superior-database SKILL.md skill
kodekateam/superior-skills · skills/superior-database/SKILL.md · Design, implement, review, or repair database schemas, queries, indexes, transactions, migrations, and backfills with…
git:20261015.f413813 · audit A · 47 stars
superior-debugging SKILL.md skill
kodekateam/superior-skills · skills/superior-debugging/SKILL.md · Diagnose and repair reproducible, intermittent, environment-specific, or production-observed software failures by…
git:20261015.f413813 · audit A · 47 stars
superior-delivery SKILL.md skill
kodekateam/superior-skills · skills/superior-delivery/SKILL.md · Design, implement, review, or repair CI/CD pipelines, release artifacts, environment promotion, deployment rollout…
git:20261015.665ae43 · audit A · 47 stars
superior-lean SKILL.md skill
kodekateam/superior-skills · skills/superior-lean/SKILL.md · Simplify coding implementations and reviews by reusing existing capabilities and removing unjustified abstractions…
git:20261029.325740f · audit A · 47 stars
superior-logic SKILL.md skill
kodekateam/superior-skills · skills/superior-logic/SKILL.md · Implement or review application behavior, APIs, state transitions, data flow, and business rules with explicit…
git:20261029.325740f · audit A · 47 stars

Every file in kodekateam/superior-skills

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