spec-mining SKILL.md skillA

spec-mining from alexander-danilenko/cortex-claude-code-plugins 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-claude-code-plugins/spec-mining@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-claude-code-plugins
Path
plugins/engineering/cortex-modernization/skills/spec-mining/SKILL.md
Versions recorded
1
Latest version
git:20261013.ecfffa1, committed Oct 13, 2026
Size
3,109 bytes
Repository stars
17
License
MIT

Apply this opinionated workflow when reverse-engineering legacy or undocumented systems: scope, explore the code, trace data flows, document in EARS format, flag uncertainties. For code archaeology, onboarding, and requirements extraction.

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

# Spec Mining

Extract a specification from a system that has no usable documentation, by reading the code that actually runs.

The discipline that makes the output trustworthy: **separate what you observed from what you inferred.** A reader will act on this document — rebuilding a service, planning a migration, onboarding — and a confident-sounding guess is worse than an acknowledged gap, because nobody goes back to check it.

## Approach

Work outside-in: entry points, then routes, then the services behind them, then the data layer. Following an actual request path teaches you the system's real structure, which is often not the structure its directory names advertise.

Read the tests too. They document intended behaviour and edge cases someone hit in production, and they are usually more honest than any comment or README in the repo.

Read the migration history as well. Migrations are dated and ordered, so they show how the schema arrived at its current shape — which columns were added under pressure, what was backfilled, what was renamed but never dropped. That sequence is often the only surviving record of why the data model looks the way it does.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add alexander-danilenko/cortex-claude-code-plugins/spec-mining@sha256:f9b3675b5f307687

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_t35ktnxusys5dx5u.svg)](https://markdownregistry.com/a/art_t35ktnxusys5dx5u)

1 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 3,109 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 (3109 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-claude-code-plugins · 17 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_t35ktnxusys5dx5u
GET https://markdownregistry.com/api/v1/resolve?ref=alexander-danilenko/cortex-claude-code-plugins/spec-mining
GET https://markdownregistry.com/api/v1/blob/f9b3675b5f3076878c4d3a4653c9f1edb4b4cb01ee6e6de79944dee9a95d14d9

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-claude-code-plugins

CLAUDE.md CLAUDE.md file
alexander-danilenko/cortex-claude-code-plugins · CLAUDE.md
git:20261013.35be08e · audit A · 17 stars
answer-buzzkill SKILL.md skill
alexander-danilenko/cortex-claude-code-plugins · 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-claude-code-plugins · 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-claude-code-plugins · 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-claude-code-plugins · 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-claude-code-plugins · 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-claude-code-plugins · 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-claude-code-plugins · plugins/engineering/cortex-jira/skills/qa-scope/SKILL.md · Draft the QA scope and plain-language Given/When/Then test scenarios for a Jira ticket, built from the full ticket, the…
git:20261013.ecfffa1 · audit A · 17 stars
report-comment SKILL.md skill
alexander-danilenko/cortex-claude-code-plugins · 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-claude-code-plugins · 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-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
learn-with-docs SKILL.md skill
alexander-danilenko/cortex-claude-code-plugins · 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

Every file in alexander-danilenko/cortex-claude-code-plugins

Other files named spec-mining

spec-mining SKILL.md skill
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-modernization/skills/spec-mining/SKILL.md · Apply this opinionated workflow when reverse-engineering legacy or undocumented systems: scope, explore the code, trace…
git:20261013.ecfffa1 · audit A · 17 stars

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