learn-with-docs-refresh SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

learn-with-docs-refresh from alexander-danilenko/cortex-ai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add alexander-danilenko/cortex-ai-skills/learn-with-docs-refresh@git:20261013.ecfffa1

Pins git:20261013.ecfffa1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
alexander-danilenko/cortex-ai-skills
Path
plugins/engineering/cortex-knowledge/skills/learn-with-docs-refresh/SKILL.md
Versions recorded
1
Latest version
git:20261013.ecfffa1, committed Oct 13, 2026
Size
8,396 bytes
Repository stars
17
License
MIT

Audit and maintain the learnings in `docs/solutions/` against the current codebase — fix drifted paths and links, merge overlapping docs, replace guidance the code no longer supports, delete obsolete docs, reconcile the `CONCEPTS.md` glossary, then report and commit. Also bootstraps `CONCEPTS.md` on request and, when asked, culls docs whose reasoning the code already explains. Use for "refresh the learnings", "audit docs/solutions", "are our solution docs still accurate…

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

# Learn With Docs Refresh

Every learning in `docs/solutions/` should still be true and still distinct. Check each one against the current code, apply what the evidence supports, and deliver a full per-doc report plus a commit. The store is only worth reading if every doc in it can be trusted.

## Hard boundaries

- **Never change product code, skills, runbooks, or instruction files** (except the consented discoverability line). When code violates guidance that has independent support, the guidance stays and the conflict goes in the report as a possible regression.
- **Never archive.** No `_archived/`, no redirect stubs — git history is the archive.
- **Act on contradiction, not on absence.** A claim the repo cannot confirm (an ops practice, an environment behavior) is not false. Age alone is not staleness.
- **No churn.** Never edit for typos, wording, or style alone.

## Paths

| Path | Role |
| --- | --- |
| `docs/solutions/**/*.md` | Candidates, excluding `README.md` and anything under `_archived/` |
| `CONCEPTS.md` (repo root) | Glossary, reconciled each run |
| `AGENTS.md` / `CLAUDE.md` | Discoverability line only, with consent |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add alexander-danilenko/cortex-ai-skills/learn-with-docs-refresh@sha256:48d826823bfe4439

The line at the top of this page pins the label git:20261013.ecfffa1, 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_abwc4ppc644yi7tl.svg)](https://markdownregistry.com/a/art_abwc4ppc644yi7tl)

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

Versions

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

versioncommittedcommitsizeaudit
git:20261013.ecfffa1 latest2026-10-13 ecfffa1 8,396 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 (8396 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

alexander-danilenko/cortex-ai-skills · 17 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_abwc4ppc644yi7tl
GET https://markdownregistry.com/api/v1/resolve?ref=alexander-danilenko/cortex-ai-skills/learn-with-docs-refresh
GET https://markdownregistry.com/api/v1/blob/48d826823bfe443988f02a3a8a387622fe233a814dff20800457237d5d3d6fa6

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 alexander-danilenko/cortex-ai-skills

CLAUDE.md CLAUDE.md file
alexander-danilenko/cortex-ai-skills · CLAUDE.md
git:20261013.35be08e · audit A · 17 stars
answer-buzzkill SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/common/cortex-communication/skills/answer-buzzkill/SKILL.md · Write a short, fact-checked reply that answers a colleague's question in one meaning only, ready to copy and paste. The…
git:20261013.ecfffa1 · audit A · 17 stars
humanize-text SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/common/cortex-communication/skills/humanize-text/SKILL.md · Remove signs of AI-generated writing from text. Use after drafting to make copy sound more natural and human-written…
git:20261013.ecfffa1 · audit A · 17 stars
simple-english SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/common/cortex-communication/skills/simple-english/SKILL.md · Write or audit technical text against ASD-STE100 Simplified Technical English so a tired, non-native reader understands…
git:20261013.ecfffa1 · audit A · 17 stars
resolve-feedback SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-coderabbit/skills/resolve-feedback/SKILL.md · Resolve CodeRabbit review feedback on a GitHub pull request. Collects every open CodeRabbit finding (inline threads…
git:20261013.ecfffa1 · audit A · 17 stars
clean-architecture SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-dotnet/skills/clean-architecture/SKILL.md · Apply these opinionated .NET 8 architecture conventions whenever structuring or reviewing a backend service: clean…
git:20261013.ecfffa1 · audit A · 17 stars
csharp SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-dotnet/skills/csharp/SKILL.md · Apply these opinionated C# conventions whenever writing or reviewing C# 12 / .NET 8+ code: nullable enabled with…
git:20261013.ecfffa1 · audit A · 17 stars
qa-scope SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-jira/skills/qa-scope/SKILL.md · Draft the QA scope and plain-language test scenarios for a Jira ticket — brief one-liners with automated test…
git:20261020.54790c2 · audit A · 17 stars
report-comment SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-jira/skills/report-comment/SKILL.md · Turn the git commits for a Jira ticket into a short, business-friendly implementation report and save it as local…
git:20261013.ecfffa1 · audit A · 17 stars
documentation SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-knowledge/skills/documentation/SKILL.md · ALWAYS invoke for any task involving docstrings, JSDoc/TSDoc, or REST API documentation — even when the request seems…
git:20261013.ecfffa1 · audit A · 17 stars
learn-with-docs SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-knowledge/skills/learn-with-docs/SKILL.md · Capture a solved, verified problem as a durable learning in `docs/solutions/` so the next agent or engineer does not…
git:20261013.ecfffa1 · audit A · 17 stars
legacy SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-modernization/skills/legacy/SKILL.md · Apply this opinionated workflow when modernizing legacy systems: strangler fig pattern, branch by abstraction…
git:20261013.ecfffa1 · audit A · 17 stars

Every file in alexander-danilenko/cortex-ai-skills

Other files named learn-with-docs-refresh

learn-with-docs-refresh SKILL.md skill
alexander-danilenko/cortex-claude-code-plugins · plugins/engineering/cortex-knowledge/skills/learn-with-docs-refresh/SKILL.md · Audit and maintain the learnings in `docs/solutions/` against the current codebase — fix drifted paths and links, merge…
git:20261013.ecfffa1 · audit A · 17 stars

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